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
@@ -0,0 +1,38 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Cardio</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.1" y1="89.5" x2="163.1" y2="121.2"><stop offset="0" stop-color="#3daba0"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="177.6" y1="128.9" x2="184.1" y2="133.0"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#12968a"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="153.0" y1="49.4" x2="169.1" y2="62.7"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#3b404c"/></linearGradient>
</defs>
<path d="M 144.6 157.4 L 207.2 157.4 L 207.2 150.2 L 144.6 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 164.1 89.5 L 163.1 121.2" stroke="url(#grad-leg_l-0)" stroke-width="3.71199" stroke-linecap="round"/>
<path d="M 163.1 121.2 L 161.4 148.7" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 161.4 148.7 L 169.1 149.2" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 168.3 30.6 L 178.8 48.5" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 178.8 48.5 L 198.8 42.1" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 160.0 89.9 L 188.9 103.8" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 188.9 103.8 L 177.6 128.9" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 177.6 128.9 L 184.1 133.0" stroke="url(#grad-leg_r-2)" stroke-width="4.18587" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 168.3 30.6 L 164.2 30.5 L 164.2 31.9" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 164.1 89.5 L 160.0 89.0 L 160.0 89.9" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 89.0 Q 162.1 59.1 164.2 30.5" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 164.2 31.9 L 153.0 49.4" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 153.0 49.4 L 169.1 62.7" stroke="url(#grad-arm_r-1)" stroke-width="4.1955" stroke-linecap="round"/>
</g>
<circle id="head" cx="165.6" cy="16.8" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="172.6" y1="16.8" x2="177.5" y2="16.8" stroke="#3a3f4b" stroke-width="2.8" 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>
<line x1="273" y1="16" x2="287" y2="16" stroke="#a9afba" stroke-width="4" stroke-linecap="round"/>
<text x="292" y="20">far</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 3.0 KiB

@@ -0,0 +1,38 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Cardio</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.1" y1="90.9" x2="168.9" y2="122.3"><stop offset="0" stop-color="#25a094"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="165.6" y1="122.5" x2="158.6" y2="149.2"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#31a59a"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.6" y1="149.2" x2="166.1" y2="151.1"><stop offset="0" stop-color="#31a59a"/><stop offset="1" stop-color="#38a99e"/></linearGradient>
</defs>
<path d="M 144.6 157.5 L 207.2 157.5 L 207.2 150.2 L 144.6 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 164.1 90.9 L 168.9 122.3" stroke="url(#grad-leg_l-0)" stroke-width="3.78058" stroke-linecap="round"/>
<path d="M 168.9 122.3 L 161.4 148.9" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 161.4 148.9 L 168.8 150.9" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 160.0 91.3 L 165.6 122.5" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 165.6 122.5 L 158.6 149.2" stroke="url(#grad-leg_r-1)" stroke-width="4.09677" stroke-linecap="round"/>
<path d="M 158.6 149.2 L 166.1 151.1" stroke="url(#grad-leg_r-2)" stroke-width="3.9732" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 168.3 32.0 L 167.9 52.7" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 167.9 52.7 L 186.6 62.1" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 168.3 32.0 L 164.2 31.9 L 164.2 33.3" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 164.1 90.9 L 160.0 90.4 L 160.0 91.3" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 90.4 Q 162.1 60.5 164.2 31.9" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 164.2 33.3 L 163.8 54.0" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 163.8 54.0 L 182.5 63.4" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
</g>
<circle id="head" cx="165.6" cy="18.2" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="172.6" y1="18.2" x2="177.5" y2="18.2" stroke="#3a3f4b" stroke-width="2.8" 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>
<line x1="273" y1="16" x2="287" y2="16" stroke="#a9afba" stroke-width="4" stroke-linecap="round"/>
<text x="292" y="20">far</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 3.0 KiB

@@ -0,0 +1,39 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Cardio</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.1" y1="89.5" x2="193.1" y2="103.4"><stop offset="0" stop-color="#3daba0"/><stop offset="1" stop-color="#70c4ba"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="193.1" y1="103.4" x2="181.7" y2="128.6"><stop offset="0" stop-color="#70c4ba"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="159.7" y1="121.6" x2="158.6" y2="149.1"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#4db3a8"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.6" y1="149.1" x2="166.3" y2="149.4"><stop offset="0" stop-color="#4db3a8"/><stop offset="1" stop-color="#4fb4a9"/></linearGradient>
</defs>
<path d="M 144.6 157.4 L 207.2 157.4 L 207.2 150.2 L 144.6 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 164.1 89.5 L 193.1 103.4" stroke="url(#grad-leg_l-0)" stroke-width="3.77565" stroke-linecap="round"/>
<path d="M 193.1 103.4 L 181.7 128.6" stroke="url(#grad-leg_l-1)" stroke-width="3.56375" stroke-linecap="round"/>
<path d="M 181.7 128.6 L 188.2 132.6" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 160.0 89.9 L 159.7 121.6" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 159.7 121.6 L 158.6 149.1" stroke="url(#grad-leg_r-1)" stroke-width="4.01364" stroke-linecap="round"/>
<path d="M 158.6 149.1 L 166.3 149.4" stroke="url(#grad-leg_r-2)" stroke-width="3.82409" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 168.3 30.6 L 157.2 48.1" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 157.2 48.1 L 173.2 61.4" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 168.3 30.6 L 164.2 30.5 L 164.2 31.9" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 164.1 89.5 L 160.0 89.0 L 160.0 89.9" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 89.0 Q 162.1 59.1 164.2 30.5" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 164.2 31.9 L 174.7 49.8" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 174.7 49.8 L 194.6 43.4" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
</g>
<circle id="head" cx="165.6" cy="16.8" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="172.6" y1="16.8" x2="177.5" y2="16.8" stroke="#3a3f4b" stroke-width="2.8" 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>
<line x1="273" y1="16" x2="287" y2="16" stroke="#a9afba" stroke-width="4" stroke-linecap="round"/>
<text x="292" y="20">far</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 3.2 KiB

@@ -0,0 +1,38 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Cardio</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.1" y1="90.9" x2="168.9" y2="122.3"><stop offset="0" stop-color="#25a094"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="165.6" y1="122.5" x2="158.6" y2="149.2"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#31a59a"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.6" y1="149.2" x2="166.1" y2="151.1"><stop offset="0" stop-color="#31a59a"/><stop offset="1" stop-color="#38a99e"/></linearGradient>
</defs>
<path d="M 144.6 157.5 L 207.2 157.5 L 207.2 150.2 L 144.6 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 164.1 90.9 L 168.9 122.3" stroke="url(#grad-leg_l-0)" stroke-width="3.78058" stroke-linecap="round"/>
<path d="M 168.9 122.3 L 161.4 148.9" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 161.4 148.9 L 168.8 150.9" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 160.0 91.3 L 165.6 122.5" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 165.6 122.5 L 158.6 149.2" stroke="url(#grad-leg_r-1)" stroke-width="4.09677" stroke-linecap="round"/>
<path d="M 158.6 149.2 L 166.1 151.1" stroke="url(#grad-leg_r-2)" stroke-width="3.9732" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 168.3 32.0 L 167.9 52.7" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 167.9 52.7 L 186.6 62.1" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 168.3 32.0 L 164.2 31.9 L 164.2 33.3" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 164.1 90.9 L 160.0 90.4 L 160.0 91.3" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 90.4 Q 162.1 60.5 164.2 31.9" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 164.2 33.3 L 163.8 54.0" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 163.8 54.0 L 182.5 63.4" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
</g>
<circle id="head" cx="165.6" cy="18.2" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="172.6" y1="18.2" x2="177.5" y2="18.2" stroke="#3a3f4b" stroke-width="2.8" 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>
<line x1="273" y1="16" x2="287" y2="16" stroke="#a9afba" stroke-width="4" stroke-linecap="round"/>
<text x="292" y="20">far</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 3.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 83 KiB

+38
View File
@@ -0,0 +1,38 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Cardio</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.1" y1="89.5" x2="163.1" y2="121.2"><stop offset="0" stop-color="#3daba0"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="177.6" y1="128.9" x2="184.1" y2="133.0"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#12968a"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="153.0" y1="49.4" x2="169.1" y2="62.7"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#3b404c"/></linearGradient>
</defs>
<path d="M 144.6 157.4 L 207.2 157.4 L 207.2 150.2 L 144.6 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 164.1 89.5 L 163.1 121.2" stroke="url(#grad-leg_l-0)" stroke-width="3.71199" stroke-linecap="round"/>
<path d="M 163.1 121.2 L 161.4 148.7" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 161.4 148.7 L 169.1 149.2" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 168.3 30.6 L 178.8 48.5" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 178.8 48.5 L 198.8 42.1" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 160.0 89.9 L 188.9 103.8" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 188.9 103.8 L 177.6 128.9" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 177.6 128.9 L 184.1 133.0" stroke="url(#grad-leg_r-2)" stroke-width="4.18587" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 168.3 30.6 L 164.2 30.5 L 164.2 31.9" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 164.1 89.5 L 160.0 89.0 L 160.0 89.9" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 89.0 Q 162.1 59.1 164.2 30.5" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 164.2 31.9 L 153.0 49.4" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 153.0 49.4 L 169.1 62.7" stroke="url(#grad-arm_r-1)" stroke-width="4.1955" stroke-linecap="round"/>
</g>
<circle id="head" cx="165.6" cy="16.8" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="172.6" y1="16.8" x2="177.5" y2="16.8" stroke="#3a3f4b" stroke-width="2.8" 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>
<line x1="273" y1="16" x2="287" y2="16" stroke="#a9afba" stroke-width="4" stroke-linecap="round"/>
<text x="292" y="20">far</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 3.0 KiB