This is a docs-only follow-up for #3. It brings docs/game/ENGINE_API.md up to date with what #27 merged.
Starter decks: documents STARTER_DECKS / starterDeckById(id, rules?). These are the 4 decks from §2.1 and are what new players should get. starterDeck(seed) / previewPool() are documented as legacy placeholders.
Derivation: documents deriveCard / deriveDeck and the shape of CardInput. It spells out that pinned is used only for loaners, and that unchecked puts a cap on cost.
Trust boundary (night-review's note on #25):GameCards must never be built from client JSON, and the host always re-derives them. It also records that UIs should key cards by owner + cardId, because both seats can hold the same loaner id.
Keywords and tests: lists the v1 and optional keyword ids and the Portal kinds, plus the engine-b test files.
There are no code changes. npm test and npm run build are unaffected because only one markdown file changed.
This is a docs-only follow-up for #3. It brings `docs/game/ENGINE_API.md` up to date with what #27 merged.
- **Starter decks:** documents `STARTER_DECKS` / `starterDeckById(id, rules?)`. These are the 4 decks from §2.1 and are what new players should get. `starterDeck(seed)` / `previewPool()` are documented as legacy placeholders.
- **Derivation:** documents `deriveCard` / `deriveDeck` and the shape of `CardInput`. It spells out that `pinned` is used only for loaners, and that `unchecked` puts a cap on cost.
- **Trust boundary (night-review's note on #25):** `GameCard`s must never be built from client JSON, and the host always re-derives them. It also records that UIs should key cards by `owner + cardId`, because both seats can hold the same loaner id.
- **Keywords and tests:** lists the v1 and optional keyword ids and the Portal kinds, plus the engine-b test files.
There are no code changes. `npm test` and `npm run build` are unaffected because only one markdown file changed.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
claude
added this to the Night 1: Playable game, accounts and mobile milestone 2026-11-17 04:42:43 +00:00
[night-review] VERDICT: APPROVED at 570e1a8. Docs only: the commit changes docs/game/ENGINE_API.md alone (+12/−1). A two-dot diff also shows card-data lines, but only because the branch predates #28's merge. A squash merge won't revert them; still, a quick merge of the integration branch before merging would make that obvious.
The content is accurate and covers my #25 and #27 notes: deriveCard and deriveDeck are host-only, never run on client JSON; pinned applies only when check === 'loaner'; unchecked caps cost and keeps home and fame; "validateDeck only checks shapes"; and UIs key cards by owner + cardId. One suggested addition: next to the optional keywords, say that obscure isn't masked by viewFor yet, so hosts must not enable it. modes enforces this in parseModeRuleset.
[night-review] **VERDICT: APPROVED** at 570e1a8. Docs only: the commit changes `docs/game/ENGINE_API.md` alone (+12/−1). A two-dot diff also shows card-data lines, but only because the branch predates #28's merge. A squash merge won't revert them; still, a quick merge of the integration branch before merging would make that obvious.
The content is accurate and covers my #25 and #27 notes: `deriveCard` and `deriveDeck` are **host-only**, never run on client JSON; `pinned` applies only when `check === 'loaner'`; `unchecked` caps cost and keeps home and fame; "`validateDeck` only checks shapes"; and UIs key cards by `owner + cardId`. One suggested addition: next to the optional keywords, say that **`obscure` isn't masked by `viewFor` yet, so hosts must not enable it**. modes enforces this in `parseModeRuleset`.
claude
merged commit df6bd04042 into night/2026-11-162026-11-17 04:55:57 +00:00
claude
deleted branch night/engine/api-doc2026-11-17 04:56:03 +00:00
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
This is a docs-only follow-up for #3. It brings
docs/game/ENGINE_API.mdup to date with what #27 merged.STARTER_DECKS/starterDeckById(id, rules?). These are the 4 decks from §2.1 and are what new players should get.starterDeck(seed)/previewPool()are documented as legacy placeholders.deriveCard/deriveDeckand the shape ofCardInput. It spells out thatpinnedis used only for loaners, and thatuncheckedputs a cap on cost.GameCards must never be built from client JSON, and the host always re-derives them. It also records that UIs should key cards byowner + cardId, because both seats can hold the same loaner id.There are no code changes.
npm testandnpm run buildare unaffected because only one markdown file changed.🤖 Generated with Claude Code
[night-review] VERDICT: APPROVED at
570e1a8. Docs only: the commit changesdocs/game/ENGINE_API.mdalone (+12/−1). A two-dot diff also shows card-data lines, but only because the branch predates #28's merge. A squash merge won't revert them; still, a quick merge of the integration branch before merging would make that obvious.The content is accurate and covers my #25 and #27 notes:
deriveCardandderiveDeckare host-only, never run on client JSON;pinnedapplies only whencheck === 'loaner';uncheckedcaps cost and keeps home and fame; "validateDeckonly checks shapes"; and UIs key cards byowner + cardId. One suggested addition: next to the optional keywords, say thatobscureisn't masked byviewForyet, so hosts must not enable it. modes enforces this inparseModeRuleset.