Platform components

The platform is deliberately layered.

Content and authoring

packages/content validates theme files, normalizes entries, enforces uniqueness, and builds indexes by theme, family, difficulty, and tone. packages/content-cli turns those capabilities into author workflows for creating, importing, analysing, refreshing, and validating content.

Engine and runtime

packages/engine contains the RuleDefinition implementation for the current anagram puzzle, deterministic candidate generation, quality analysis, answer evaluation, season resolution, historical snapshots, and runtime status. The runtime loads content and season configuration once, then exposes a stable snapshot to consumers.

Delivery

apps/api adapts engine capabilities to HTTP routes and adds caches, request validation, telemetry, and administrative operations. apps/web consumes the public API and provides the player experience. packages/dto keeps API payloads explicit and validated at the boundary.

Supporting systems

The sustainability engine produces publication evidence and reports. The soundscape engine supplies the web experience’s audio behavior. The documentation site is a separate static application and does not participate in request handling.