RGreview-game-corethe engine behind concept-first review games

Overview

Introduction

Start here for the package framing, site structure, and the three public surfaces of the docs site.

Route: /docs

review-game-core is the shared package behind the review-game repos in this workspace. It ships pure TypeScript contracts and helpers for:

  • concept-first question flows
  • the six-phase quiz engine
  • the guided repetition ladder (light / hard / recovery-light)
  • policy-driven concept scheduling
  • ordered planning and goal evaluation
  • workflow session, content-identity restore, and debug contracts
  • readiness scoring and phase-state rollups
  • per-question experiment gating and exposure records
  • WF well-formedness validation and deterministic question-quality rules
  • graph projection for authored learning structure

The site has three surfaces:

  • / for the package showcase and consumer examples
  • /showcase/features for feature-by-feature examples
  • /docs for the canonical documentation base

What the package is for

The package grew out of "review game" repos, but the stronger framing is concept-first learning with review and cram as modes.

That means consumer apps usually:

  1. identify the governing idea first
  2. check structure or setup second
  3. ask for independent proof later
  4. revisit the concept with spaced retention or repair

How to read the site

  • Use Quick Start if you want a minimal integration path.
  • Use Planning / Goal Family if you need launcher or recommendation logic.
  • Use Migration Notes if you are deciding what belongs in core and how to normalize existing consumer mechanisms.
  • Use Feature Showcase when you want a concrete example before reading deeper docs.
  • Use Consumer Example Mirroring if you need the deployment boundary for stats and Math1111 examples.
  • Use docs/wf-kit.md when deciding whether browser harness evidence is enough or a low-context WF pass is required.

Consumer repos represented here

  • stats-exam-prep-game
  • math-1111-review-game

Those repos provide the real usage patterns shown throughout the site. The examples are sourced from their actual adapters and launchers rather than invented demo code.