Files
workouts/Exercise Library
rzen 79e75a9127 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
2026-07-12 00:37:23 -04:00
..

Exercise Library

Reference material for exercises the app knows about — one folder per exercise, named exactly as the exercise appears in the app.

Each entry contains:

  • info.md — the details, always in this order: a one-line summary, quick facts (Category, Type, Targets, Prescription), then Setup, Execution, Cues, Common Mistakes, and Progression (easier → harder — get strong by making the move harder, not by endless reps).
  • motion.json — the exercise scripted as key frames of joint angles on the shared rig (proportions in the library-level body.json), with IK pins for planted hands/feet and tween timings. This is the canonical source for all visuals and for the in-app animation planned for the lower half of the exercise screen.
  • Generated from it by render.py (never hand-edited): frames/frame-N.svg (one per key frame), preview.gif (the tweened loop), and visual.svg (the primary frame, for static contexts).

Which exercises the library must contain — the movement-pattern × modality matrix, the gym-floor census, and the considered exclusions — is defined in COVERAGE.md; judge additions and removals against it.

The rig and the visual language — right limbs dark / left limbs light with an embedded R/L legend, nose tick for facing, teal on the working parts, timing that encodes tempo, plus figure profiles, flipping, and theming — are defined in SYSTEM.md, along with the motion.json schema and rendering instructions.

The library lives at the repo root, deliberately outside the app targets' source folders, and is not bundled into the app yet — the in-app presentation format is still being worked out.