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,31 +1,29 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Standing Quad Stretch</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="#a5abb6"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="166.2" y1="31.9" x2="183.9" y2="21.0"><stop offset="0" stop-color="#a7adb8"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="153.5" y1="52.1" x2="157.2" y2="72.4"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#424753"/></linearGradient>
<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="#808691"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
</defs>
<path d="M 117.9 157.5 L 209.2 157.5 L 209.2 150.2 L 117.9 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.51327" stroke-linecap="round"/>
<path d="M 164.1 90.9 L 168.9 122.3" stroke="url(#grad-leg_l-0)" stroke-width="3.6289" stroke-linecap="round"/>
<path d="M 168.9 122.3 L 161.4 148.9" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 161.4 148.9 L 168.8 150.9" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 166.2 31.9 L 183.9 21.0" stroke="url(#grad-arm_l-0)" stroke-width="3.50743" stroke-linecap="round"/>
<path d="M 166.2 31.9 L 183.9 21.0" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 183.9 21.0 L 199.4 7.1" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 166.2 31.9 L 162.1 31.8 L 162.1 33.2" 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 161.1 60.4 162.1 31.8" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_r">
<path d="M 160.0 91.3 L 129.2 82.0" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 129.2 82.0 L 155.8 73.3" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 155.8 73.3 L 159.6 66.7" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 160.0 91.3 L 150.6 121.6" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 150.6 121.6 L 141.9 95.4" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 141.9 95.4 L 135.1 91.9" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 162.1 33.2 L 153.5 52.1" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 153.5 52.1 L 157.2 72.4" stroke="url(#grad-arm_r-1)" stroke-width="4.17451" stroke-linecap="round"/>
<path d="M 162.1 33.2 L 146.5 47.0" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 146.5 47.0 L 155.0 65.9" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
</g>
<circle id="head" cx="163.1" cy="18.1" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="170.0" y1="17.8" x2="174.9" y2="17.7" stroke="#3a3f4b" stroke-width="2.8" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.0 KiB

After

Width:  |  Height:  |  Size: 2.6 KiB

@@ -22,9 +22,9 @@
"neck": 2, "head": -6,
"shoulder_r": -46, "elbow_r": 72,
"shoulder_l": {"flexion": 122, "abduction": 14}, "elbow_l": 10,
"hip_r": -8, "knee_r": 145, "ankle_r": -48,
"hip_r": -15, "knee_r": 145, "ankle_r": -45,
"hip_l": 2, "knee_l": 2, "ankle_l": 0,
"pins": {"foot_l": [162, 150], "foot_r": [154, 38], "hand_r": [156, 36]}
"pins": {"foot_l": [162, 150]}
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 201 KiB

After

Width:  |  Height:  |  Size: 196 KiB

@@ -1,31 +1,29 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Standing Quad Stretch</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="#a5abb6"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="166.2" y1="31.9" x2="183.9" y2="21.0"><stop offset="0" stop-color="#a7adb8"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="153.5" y1="52.1" x2="157.2" y2="72.4"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#424753"/></linearGradient>
<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="#808691"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
</defs>
<path d="M 117.9 157.5 L 209.2 157.5 L 209.2 150.2 L 117.9 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.51327" stroke-linecap="round"/>
<path d="M 164.1 90.9 L 168.9 122.3" stroke="url(#grad-leg_l-0)" stroke-width="3.6289" stroke-linecap="round"/>
<path d="M 168.9 122.3 L 161.4 148.9" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 161.4 148.9 L 168.8 150.9" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 166.2 31.9 L 183.9 21.0" stroke="url(#grad-arm_l-0)" stroke-width="3.50743" stroke-linecap="round"/>
<path d="M 166.2 31.9 L 183.9 21.0" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 183.9 21.0 L 199.4 7.1" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 166.2 31.9 L 162.1 31.8 L 162.1 33.2" 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 161.1 60.4 162.1 31.8" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_r">
<path d="M 160.0 91.3 L 129.2 82.0" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 129.2 82.0 L 155.8 73.3" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 155.8 73.3 L 159.6 66.7" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 160.0 91.3 L 150.6 121.6" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 150.6 121.6 L 141.9 95.4" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 141.9 95.4 L 135.1 91.9" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 162.1 33.2 L 153.5 52.1" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 153.5 52.1 L 157.2 72.4" stroke="url(#grad-arm_r-1)" stroke-width="4.17451" stroke-linecap="round"/>
<path d="M 162.1 33.2 L 146.5 47.0" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 146.5 47.0 L 155.0 65.9" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
</g>
<circle id="head" cx="163.1" cy="18.1" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="170.0" y1="17.8" x2="174.9" y2="17.7" stroke="#3a3f4b" stroke-width="2.8" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.0 KiB

After

Width:  |  Height:  |  Size: 2.6 KiB