clone

fifteen puzzle games for the terminal, with daily puzzles, weekly ladders and xp, built on bubble tea

chore/app-model-decomp
puzzletea / openspec / specs / create-and-seeded-play / spec.md
spec.md 1.5K rendered
1## Purpose2Describe the interactive Create workflow, variant selection, Elo targeting, and deterministic seed behavior.34## Requirements56### Requirement: Create Uses Variants And Elo7The Create screen SHALL present selectable variant leaves, require a valid target Elo from 0 through 3000, and spawn the selected variant using Elo generation.89#### Scenario: Generate from one checked variant10- **WHEN** exactly one variant leaf is checked and the user generates11- **THEN** PuzzleTea uses that variant, the entered Elo, and the optional seed if supplied1213#### Scenario: Generate from multiple checked variants14- **WHEN** multiple variant leaves are checked15- **THEN** PuzzleTea chooses one checked leaf uniformly and disables deterministic seed entry for that intentionally random selection1617### Requirement: Seeded Create Resume18The Create workflow MUST resume an existing deterministic save when the same seed, game, variant, and Elo identify a prior record.1920#### Scenario: Reuse create seed21- **WHEN** a single selected variant has a nonblank seed matching an existing deterministic record22- **THEN** PuzzleTea imports and resumes that record instead of creating a duplicate2324### Requirement: Global Seed Selection25The `--set-seed` flow SHALL deterministically select game, legacy seeded mode, name, and puzzle content from a seed string.2627#### Scenario: Launch by global seed28- **WHEN** the user runs `puzzletea new --set-seed <seed>`29- **THEN** PuzzleTea rejects explicit game arguments and resumes or creates the deterministic puzzle for that seed