Fix live angle previews and improve LLM authoring guidance

[a-baran-orhan]

Summary

• preview direct angle edits at the endpoint of the affected phase and pause the viewer there
• preserve the existing replay behavior for ordinary text edits
• expand the LLM authoring guide with the product execution model, exact output contract, closed vocabulary, compatibility tables, and repair workflow
• parse every Posecode guide example in the documentation contract tests

Root cause

The parser and renderer already honored edited angles, but every successful edit reloaded the timeline at time zero and immediately resumed playback. Fast phases such as the front kick's 0.5-second chamber made valid edits appear to have no effect. Direct angle edits now carry their source line through recompilation, resolve that line to its phase, and hold the corresponding key pose for immediate visual feedback.

Impact

Changing an inline angle control, for example knee_right: flex 90 to 10, now jumps to and holds the edited pose. LLMs also receive more precise, product-specific instructions designed to prevent invented syntax, invalid contact combinations, contradictory cues, and accidental loop resets.

Validation

• npx vitest run --exclude playground/test/positioning.test.ts — 429 tests passed
• npm run typecheck
• npm run build
• browser verification against the production front-kick behavior and the fixed local build
• guide examples verified parseable and warning-free

The excluded positioning test is affected only by unrelated, uncommitted landing-page work in the local worktree; those files are not part of this PR.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
posecode	Ready	Preview	Aug 1, 2026 6:44pm