feat(rules): character-sheet assembly — deriveSheet()

[StreamDemon]

The pure character-assembly that turns a player's choices into a complete computed sheet — the culmination of the rules engine, and the function the Convex backend will serve.

What's included

• schema/character.ts — Character: the player's choices (O.C.C. id, level, 8 attributes, H2H type, skill picks + their bonuses, spell picks, optional recorded rolled H.P./S.D.C./P.P.E.). Derived stats are computed, never stored.
• engine/character.ts — deriveSheet(character): validates the character, then assembles:
  • identity (O.C.C. name/category) + attribute bonuses
  • combat profile: attacks/melee, strike, parry, dodge, damage bonus
  • vitals: H.P. & S.D.C. ranges (or the recorded roll) + coma/death floor
  • P.P.E. range + spell strength
  • a saves map combining attribute and O.C.C. bonuses with their d20 targets
  • resolved skill percentages and known spells

Pure and deterministic — dice rolls are inputs (character.rolled), not generated — so it runs anywhere.

Verification

• vp run rules#test → 70 tests (9 new), asserting a full level-1 Ley Line Walker sheet (attacks 4, P.P.E. 64–214, spell strength 12, Wilderness Survival 44%, +4 vs Horror Factor, …)
• vp run rules#check → clean

Next

This is the sheet the Convex backend will persist + serve. Convex setup needs an interactive npx convex dev login, so that lands in a follow-up once the deployment is provisioned.

---

Summary by cubic

Adds deriveSheet to compute a complete character sheet from a player's choices. Now level-aware P.P.E., psionics saves honor the character’s psychic class, and duplicate skills/spells are rejected.

• New Features

  • Added engine/character.ts: deriveSheet(character) validates input and returns identity, attribute bonuses, combat profile, vitals, P.P.E./spell strength, saves, resolved skills, and known spells.
  • Added schema/character.ts: Character schema for choices (O.C.C., level, attributes, H2H, skills with bonuses, spellIds, optional rolled H.P./S.D.C./P.P.E., psychicClass with default "ordinary").
  • Exported new schema and engine from index.ts; tests assert a level‑1 Ley Line Walker sheet.

• Bug Fixes

  • P.P.E. now uses a level-aware range (base plus per-level gains).
  • Psionics save target is derived from the character’s psychicClass.
  • Schema rejects duplicate skillId and spellId entries.

^{Written for commit efe3af0. Summary will update on new commits.}

[cubic-dev-ai]

4 issues found across 4 files

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

0 issues found across 4 files (changes from recent commits).

<sub>Requires human review: Core character sheet assembly function with complex derivation logic; requires domain expert review for correctness.

Re-trigger cubic</sub>