Merge origin/main into feat/fidelity-and-launch-prep

Reconcile this branch's fidelity/eval/MCP work with the Posecode rename and
feature expansion that landed on main (65+ new examples, fingers rig, props,
pins, reach-IK, travel/turn choreography).

Resolution:
- Ported posecode-eval (headless probe + invariant scorecard) onto main's rig:
  probe now mirrors the viewer's full root pipeline (yaw/travel → ground-lock →
  floor clamp); checks retargeted to main's pelvis:hinge semantics and real
  phase names; dropped bone-origin contact checks that don't hold under main's
  mesh-grounding. 361/361 checks across all 73 examples.
- Re-extracted main's mesh-aware ground-lock into posecode-render/groundlock.ts
  (shared by viewer + eval); added Viewer.captureFrame(); playground exposes
  window.__posecodeViewer.
- Made posecode-mcp publishable (esbuild bin bundle, server.json registry
  manifest, posecode.org permalinks).
- README: playground link, render GIFs, eval/safety section.
- Took main's version of all overlapping parser/renderer/spec files — main
  already implements the hinge + torso/abduction sign fixes under its own
  design, so this branch's earlier parser edits were dropped as superseded.

Author: a-baran-orhan

.gitignore

@@ -5,3 +5,4 @@ coverage/
 .DS_Store
 .vite/
 .vercel
+.claude/worktrees/

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Movit
+Copyright (c) 2026 Posecode
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,21 +1,21 @@
-<h1 align="center">◆ Movit</h1>
+<h1 align="center">◆ Posecode</h1>
 
 <p align="center"><b>Kinematic motion as text.</b> Mermaid gave LLMs a way to draw diagrams.<br/>
-Movit gives them a way to <i>show movement</i> — exercises, physiotherapy, posture —<br/>
+Posecode gives them a way to <i>show movement</i> — exercises, physiotherapy, posture —<br/>
 as a tiny human-readable language that renders to an animated 3D figure in the browser.</p>
 
 <p align="center">
-  <a href="https://www.posecode.org/play"><b>▶ Live playground</b></a> ·
+  <a href="https://posecode.org/play"><b>▶ Live playground</b></a> ·
   <a href="spec/SPEC.md">Language spec</a> ·
   <a href="spec/examples">Examples</a> ·
-  <a href="packages/movit-mcp">MCP server</a>
+  <a href="packages/posecode-mcp">MCP server</a>
 </p>
 
 <table align="center">
   <tr>
-    <td align="center"><img src="docs/media/deadlift.gif" width="230" alt="Deadlift rendered from .movit text"/><br/><sub><code>hips: hinge 70</code> — deadlift</sub></td>
-    <td align="center"><img src="docs/media/squat.gif" width="230" alt="Body-weight squat rendered from .movit text"/><br/><sub><code>knees: flex 95</code> — squat</sub></td>
-    <td align="center"><img src="docs/media/lateral-raise.gif" width="230" alt="Lateral raise rendered from .movit text"/><br/><sub><code>shoulders: abduct 90</code> — lateral raise</sub></td>
+    <td align="center"><img src="docs/media/deadlift.gif" width="230" alt="Deadlift rendered from .posecode text"/><br/><sub><code>pelvis: hinge</code> — deadlift</sub></td>
+    <td align="center"><img src="docs/media/squat.gif" width="230" alt="Body-weight squat rendered from .posecode text"/><br/><sub><code>knees: flex 95</code> — squat</sub></td>
+    <td align="center"><img src="docs/media/lateral-raise.gif" width="230" alt="Lateral raise rendered from .posecode text"/><br/><sub><code>shoulders: abduct 90</code> — lateral raise</sub></td>
   </tr>
 </table>
 
@@ -29,16 +29,16 @@ descent") — it just has no syntax to express it that a renderer can read.
 Diffusion-based text-to-motion models exist, but they're heavy, expensive, and
 give you no fine control over the anatomical phases.
 
-Movit takes the opposite, lightweight approach (see [the research](#background)):
+Posecode takes the opposite, lightweight approach (see [the research](#background)):
 
-- The LLM writes a small **`.movit`** document — semantic phases, not 3D matrices.
+- The LLM writes a small **`.posecode`** document — semantic phases, not 3D matrices.
 - A **client-side** parser + Three.js renderer animates it. Generation is a
   fraction of a cent of text; rendering runs at 60fps on a phone.
 - Every angle is **hard-clamped to a healthy range of motion**, so a model
   hallucinating "knee flex 200°" can't produce an anatomically impossible joint.
 
-```movit
-movit exercise "Body-weight squat"
+```posecode
+posecode exercise "Body-weight squat"
   rig humanoid
   pose start = standing
 
@@ -61,72 +61,59 @@ movit exercise "Body-weight squat"
 
 ## Try it
 
-**No install:** open the [live playground](https://www.posecode.org/play),
-pick an example, edit the text, watch the figure move. Hit **Copy LLM prompt**
-to get a system prompt that teaches ChatGPT/Claude to write Movit for you —
-or wire up the [MCP server](packages/movit-mcp) so your agent authors,
-validates, and renders movements natively.
-
-**Locally:**
-
 ```bash
 npm install
 npm run dev      # opens the playground (Vite) at http://localhost:5173
 npm test         # parser + renderer + eval test suites
 npm run eval     # fidelity scorecard: geometric invariants over every example
 ```
 
-## Examples
-
-Fourteen ready-to-paste movements live in [`spec/examples`](spec/examples) —
-squat, deadlift, push-up, biceps curl, lateral raise, forward fold, roll-down,
-chair pose, side bend, spinal twist, neck rotation, shoulder stretch, and two
-posture resets. A hip hinge is one line:
-
-```movit
-step "Hinge down" 2s ease-in-out:
-  hips: hinge 70        # closed-chain: torso tips over planted feet
-  knees: flex 20
-  ground-lock: feet
-  cue "Push the hips back, chest up, flat back"
-```
+In the playground: pick an example, watch it animate, edit the text live, and
+hit **Copy LLM prompt** to get a system prompt that teaches ChatGPT/Claude to
+write Posecode for you — or wire up the [MCP server](packages/posecode-mcp) so
+your agent authors, validates, and renders movements natively.
 
-## How Movit stays honest
+## How Posecode stays honest
 
 Two safety layers ship with the language:
 
 - **ROM clamping** — every angle is hard-clamped to healthy range-of-motion
-  tables before rendering; a hallucinated `knee: flex 200` renders at 144°
-  with a warning, never an impossible joint.
-- **Fidelity evals** — [`movit-eval`](packages/movit-eval) re-runs the real
-  parser → FK → ground-lock pipeline headlessly and scores geometric
-  invariants ("a deadlift pitches the torso ≥ 55° with a flat back and
-  vertical shins"). Every example must pass every invariant in CI.
+  tables before rendering; a hallucinated `knee: flex 200` renders at its
+  ceiling with a warning, never an impossible joint.
+- **Fidelity evals** — [`posecode-eval`](packages/posecode-eval) re-runs the
+  real parser → FK → ground-lock pipeline headlessly and scores geometric
+  invariants ("a deadlift pitches the torso ≥ 50° with vertical shins"). Every
+  example must pass every invariant in CI.
 
 ## Packages
 
 | Package | What it does |
 | --- | --- |
-| [`movit-parser`](packages/movit-parser) | `.movit` text → validated, ROM-clamped IR. Pure TypeScript, framework-agnostic. |
-| [`movit-render`](packages/movit-render) | IR → animated low-poly mannequin (Three.js), forward kinematics + ground-lock CCD IK. |
-| [`movit-share`](packages/movit-share) | Encode a `.movit` doc to a URL-safe token so a movement travels as a link. Pure, dependency-free. |
-| [`movit-mcp`](packages/movit-mcp) | MCP server: lets an LLM agent author, ROM-validate, and get a render link for a movement — natively. |
-| [`movit-eval`](packages/movit-eval) | Fidelity harness: headless kinematic probing + biomechanical invariant scoring. |
-| [`movit-language`](packages/movit-language) | Editor smarts (completion, hover docs, diagnostics) shared by CodeMirror and the LSP. |
-| [`movit-lsp`](packages/movit-lsp) | Language Server Protocol server + [VS Code extension](editors/vscode). |
+| [`posecode-parser`](packages/posecode-parser) | `.posecode` text → validated, ROM-clamped IR. Pure TypeScript, framework-agnostic. |
+| [`posecode-render`](packages/posecode-render) | IR → animated low-poly mannequin (Three.js), forward kinematics + ground-lock CCD IK. |
+| [`posecode-share`](packages/posecode-share) | Encode a `.posecode` doc to a URL-safe token so a movement travels as a link. Pure, dependency-free. |
+| [`posecode-mcp`](packages/posecode-mcp) | MCP server: lets an LLM agent author, ROM-validate, and get a render link for a movement — natively. |
+| [`posecode-eval`](packages/posecode-eval) | Fidelity harness: headless kinematic probing + biomechanical invariant scoring. |
 | [`playground`](playground) | Live editor + 3D viewport + warnings + the LLM prompt + shareable links. |
 
 The protocol and both libraries are **MIT-licensed** — the open core. See
 [`spec/SPEC.md`](spec/SPEC.md) for the full language and
 [`spec/llm-authoring.md`](spec/llm-authoring.md) for the authoring prompt.
+For where Posecode spreads fastest and the per-domain go-to-market plan, see
+[`docs/market-research.md`](docs/market-research.md); for the engine roadmap,
+[`ROADMAP.md`](ROADMAP.md).
 
 ## Scope (v0.1)
 
-✅ Single-person fitness, stretching & posture · Mermaid-style DSL · ROM safety
-clamping · forward kinematics · ground-lock IK · live playground.
+✅ Single-person movement across fitness, physio, desk, dance, education & rehab ·
+Mermaid-style DSL · ROM safety clamping (authored **and IK-solved** angles) ·
+forward kinematics · ground-lock **and ROM-constrained reach-to-target IK** ·
+hip-hinge · lying/seated poses · scene props (chair/wall/bar) · a single-DOF
+hand rig · live playground.
 
-⏳ Deferred: reach-IK, two-person / partner movements + collision detection,
-FBX/GLB export, hosted SaaS editor and the expert-verified motion marketplace.
+⏳ Deferred: two-person / partner movements + collision detection, deeper props
+(load, bands, rings), multi-joint fingers, FBX/GLB export, hosted SaaS editor and
+the expert-verified motion marketplace.
 
 ## Background
 
@@ -136,6 +123,6 @@ specifies ROM-based safety constraints from clinical normative data, and lays
 out the open-core commercialization path. The spec cross-references its
 sections (§4 DSL, §5 biomechanics, §6 client rendering, §7 strategy).
 
-> ⚠️ Movit's range-of-motion values are general literature data, not medical
+> ⚠️ Posecode's range-of-motion values are general literature data, not medical
 > advice. Consult a qualified professional for physiotherapy or exercise
 > prescription.

ROADMAP.md

@@ -1,12 +1,12 @@
-# Movit — domains & roadmap
+# Posecode — domains & roadmap
 
-Movit's vision is broad: **describe any single-person movement as text and render it
+Posecode's vision is broad: **describe any single-person movement as text and render it
 safely in 3D.** The *protocol* is general; the *current renderer* is deliberately
 scoped (one figure, forward kinematics, ground-locked hands/feet, no props). This
-doc maps the domains Movit can serve, what already works, and what each remaining
+doc maps the domains Posecode can serve, what already works, and what each remaining
 domain needs — so contributions land where they unlock the most.
 
-## Where Movit fits
+## Where Posecode fits
 
 | Domain | Example uses | Status |
 | --- | --- | --- |
@@ -17,27 +17,44 @@ domain needs — so contributions land where they unlock the most.
 | **Fitness / strength** | Body-weight and free-form movement coaching | ✅ Core today (squat, curl, raise). Barbell/dumbbell/machine work needs props + grip. |
 | **Functional / elderly care** | Sit-to-stand, balance, gentle ROM, fall-prevention drills | 🟡 Partial — sit-to-stand works; reaching/balance need reach-IK + props. |
 | **Sports technique** | Golf swing, tennis serve, throwing, kicking | 🟡 Partial — needs trunk rotation fidelity, weight shift, and implements (club/racket/ball). |
-| **Dance / choreography** | Notating sequences, port de bras, simple phrases | 🟡 Simple gestures work; precise reach + partner work are future. |
+| **Dance / choreography** | Notating sequences, port de bras, phrases that turn & travel | ✅ Phrases, port de bras, pirouettes, and traveling combos (box-step, grapevine, chassé) work via `turn`/`travel`; partner work is future. |
 | **Martial arts** | Stances, strikes, basic forms | 🟡 Stances/strikes partly work; contact and weapons are future. |
-| **Sign language / gesture** | Finger-spelling, signs, expressive gesture | ⛔ Needs a hand/finger rig (the rig currently ends at the wrist). |
+| **Sign language / gesture** | Finger-spelling, signs, expressive gesture | 🟡 Partial — single-DOF finger curls render visibly (fist, pinch, wave, rough finger-spelling); exact sign language needs multi-joint fingers + wrist orientation. |
 
 ## Engine capabilities that widen the scope
 
 These are the unlocks, roughly in order of leverage:
 
-1. **Hip / waist hinge primitive** — today deadlift / forward-fold are faked as a
-   spinal roll-down. A true hip hinge unlocks deadlift, row, good-morning, hinge-based
-   yoga, and bending to interact with props.
-2. **Reach-IK (reach a world target)** — touch your toes, hand-to-opposite-knee,
-   grab a bar, place a hand on a wall. Unlocks a huge share of physio, yoga, and any
-   prop interaction.
-3. **Scene props with contact anchors** — objects the figure can stand on, sit on,
-   hang from, or push against, plus ground-lock-style anchors to them.
-4. **Lying & seated base poses** — supine / prone / quadruped / seated starting poses
-   (for floor yoga, mat Pilates, bed-based rehab, sit-to-stand on a real seat).
-5. **Hand / finger articulation** — grip and gesture (sign language, grasping props).
-6. **Two-person + collision** — partner stretches, assisted rehab, contact sports
-   (already noted as deferred in the spec).
+1. ~~**Hip / waist hinge primitive**~~ — ✅ **shipped (v0.1).** `pelvis: hinge <deg>`
+   tips the torso forward over the hips while the legs stay planted (the renderer
+   counter-rotates the hips). Powers `deadlift`, `bent-over-row`, `good-morning`,
+   and `bow`. Next: hinge with a loaded-bar prop.
+2. ~~**Reach-IK (reach a world target)**~~ — ✅ **shipped, now ROM-constrained.**
+   `reach: <effector> <target>` drives a hand/foot to a body landmark, the
+   `floor`, or a prop anchor via CCD. Powers `touch-toes`, `cross-body-reach`,
+   `seated-forward-fold`, and prop grips. The solve clamps every chain joint
+   into its Range-of-Motion box each iteration — solved angles obey the same
+   hard limits as authored ones — and `hands` / `feet` reach or pin both sides
+   in one line. Next: two-bone analytic solve for straighter elbows/knees.
+3. ~~**Scene props with contact anchors**~~ — ✅ **shipped (starter set).** `prop
+   chair|wall|bar` adds a scene object with named anchors (`seat`, `wall`, `bar`).
+   Powers `sit-to-stand`, `box-squat`, `wall-sit`, `dead-hang`, `hanging-knee-raise`.
+   Next: more props (bench, rings, bands), load cues, anchor-aware ground-lock.
+4. ~~**Lying & seated base poses**~~ — ✅ **shipped.** `supine | prone | seated`
+   start poses (grounded by a bounding-box drop). Powers `glute-bridge`,
+   `dead-bug`, `cobra`, `seated-forward-fold`. Next: quadruped + chair-seated.
+5. ~~**Hand / finger articulation**~~ — ✅ **shipped (single-DOF).** Per-finger
+   curl bones + `fingers` group. Powers `make-a-fist`, `pinch-grip`, `hand-wave`,
+   `finger-spell-demo`. Next: multi-joint fingers for accurate sign language.
+6. ~~**Spatial choreography (turn & travel)**~~ — ✅ **shipped.** `turn: <deg>`
+   rotates the figure's facing and `travel: <x> <z>` moves it across the floor,
+   both absolute + carried across phases and returning home on the loop wrap.
+   Powers `pirouette`, `box-step`, `grapevine`, `waltz-box`, `chasse`,
+   `walk-cycle`, `quarter-turns` — pirouettes, traveling combos, and gait.
+   Standing poses only. Next: footstep-locked travel (true gait), motion
+   aliveness (velocity-continuous flow + weight shift).
+7. **Two-person + collision** — partner stretches, assisted rehab, contact sports
+   (still deferred in the spec).
 
 ## Prop / equipment library (future)
 
@@ -55,15 +72,23 @@ Each prop is a small scene object + an anchor type; movements then reference it
 | **Resistance band** | Band pull-aparts, banded rehab, mobility with tension |
 | **Dumbbell / barbell / kettlebell** | Loaded strength patterns (needs grip + load cues) |
 | **Ball (stability / medicine)** | Core work, balance, throws |
-| **Parallettes / dip station** | Dips, L-sits, push-up variations at height |
+| **Parallettes / dip station** | ✅ Dip bars shipped (`prop dip-bars` — triceps dips). Still future: L-sits, push-up variations at height |
 | **Foam roller** | Self-myofascial release, mobility drills |
 
 ## Current limitations (honest)
 
-- One figure only; no props or external objects yet.
-- Forward kinematics + ground-locked hands/feet; **no reach-to-target IK**.
-- Hip/waist hinge is approximated by spinal flexion (so deadlift-class moves look
-  like a roll-down — curate around this until the hinge primitive lands).
-- Rig ends at the wrist (no fingers) and the head (no facial articulation).
+- One figure only; partner work and collision are still deferred.
+- A **starter** prop set (chair / wall / bar / box / dip bars) — no bench,
+  rings, bands, or loaded implements yet, and props sit at fixed default
+  placements.
+- Props are visual + reach anchors (no physical sit/lean solve).
+- Fingers are **single-DOF** curls — good for grip and rough gesture, not exact
+  sign language. The head has no facial articulation.
 
 > Range-of-motion values are general literature data, not medical advice.
+
+---
+
+See [`docs/market-research.md`](docs/market-research.md) for where Posecode spreads
+fastest, the per-domain go-to-market briefs, and which engine unlock opens which
+locked domain.