@onceworlds/cli 0.9.1 → 0.9.3

package/README.md

@@ -83,10 +83,14 @@ from the running game and commit them under `store/`. `onceworlds doctor` says w
 
 ## Commands
 
-- `onceworlds new [folder] --kit <name>` starts a game from a kit: a complete game on the engine, one per kind of game
-  (`--list` shows them). It writes the kit with an `onceworlds.json` for your game (`--name`, `--slug`, `--description`;
-  the folder's name by default), the engine guide as `AGENTS.md` and `CLAUDE.md`, and the kit's own notes (what each file
-  does, what to change, its tests) as `KIT.md`. `--template party` or `starter` starts a small game on the SDK alone.
+- `onceworlds new [folder]` starts a game: a blank engine project (`--space 3d` for 3D) with nothing that decides the game, only
+  the wiring: a `game.config.js` with a camera and an empty action map, a test that plays it through a reloaded host and a dropped
+  player, an `onceworlds.json` for your game (`--name`, `--slug`, `--description`; the folder's name by default), the engine guide
+  as `AGENTS.md` and `CLAUDE.md`, and a `DESIGN.md` to fill in first (the hook and signature mechanic, an originality pass, the first
+  minute, the art direction, the feel, the UI and a pre-build check). `--kit <name>` starts from a kit instead: a complete game of
+  one kind (`--list` shows them), a reference for its plumbing (rooms, netcode, Flow, bots, tests) whose idea, look and screens are
+  never yours. A kit adds its own notes as `KIT.md` and its fingerprints as `.onceworlds/kit.json`, so `check` can note what is
+  still the kit's. `--template party` or `starter` starts a small game on the SDK alone.
 - `onceworlds check [dir]` is what to run before a deploy: doctor's findings and, for an engine game, the game's own tests
   (`npm test`) and simulated matches played with no browser, with a reloaded host, a dropped player, the host changing (also while
   paused), a late joiner and garbage messages. A failing test or a match with errors exits with an error. The game's config is
@@ -120,7 +124,11 @@ from the running game and commit them under `store/`. `onceworlds doctor` says w
   game the list is the engine's own (`controlsFromActions` on the `actions` that `game.config.js` exports); otherwise it is read
   from the source text (`Input.axis2d`, `Input.button`) and may differ. It checks `onceworlds.json` by every rule a deploy applies
   (lengths, genres, badges, How to play, the pictures it names), in the deploy's words and with the fix, and fails as the deploy
-  would; the rest only suggests (`--strict` exits with an error on likely bugs, for CI). `check` does the same.
+  would; the rest only suggests (`--strict` exits with an error on likely bugs, for CI). `check` does the same. For an engine
+  game it also says when `DESIGN.md` is missing or has parts left empty (the originality pass included), and notes a game still
+  close to the kit it started from (scripts unchanged, the kit's numbers, its screens). For a game on Flow it says what still
+  looks like a kit (Flow's placeholder screens, the default theme), a 3-2-1 of the game's own beside Flow's, and a first round
+  no different from the rest. Taste is the game's: these are warnings and notes, never a failure.
 
 - `onceworlds api <name or words>` looks the engine up in a few lines instead of the whole reference: a signature, what it
   does, a component's fields or an options object's keys, and an example (`api Shape2D`, `api feel.shake`, `api "camera follow"`;
@@ -132,7 +140,9 @@ from the running game and commit them under `store/`. `onceworlds doctor` says w
   with bots (`--at 20`), the title screen (`--phase title`) or the lobby (`--phase lobby`), or a poster (`--poster cover`), at
   `--size 1280x720` by default. A 2D game is drawn with no browser, from
   the frame the engine draws, in the engine's font; a 3D game (or `--browser`) is drawn by Chrome, Chromium or Edge from a local
-  copy of the game. `--out` picks the file (default `store/shot.png`).
+  copy of the game. `--out` picks the file (default `store/shot.png`). `--story` plays the first minute as a new player lives it
+  (the title, the lobby, the countdown, the round's goal, play at +1, +5 and +12 s, the first result), saves each frame into
+  `store/story/` and lays them out on one contact sheet, `store/story.png`, with the questions to ask of it.
 
 Running `onceworlds mcp` gives an AI tool the same as tools: `api_lookup`, `recipe`, `read_guide`, `search_assets` (the engine's
 asset library), `check`, `screenshot` (the picture comes back to the model), `new_game`, `deploy_preview`, `playtest` and