From cf2fceb060716dad99216d0ab3aee4999c6546d4 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:01:28 -0500 Subject: [PATCH 1/4] docs/game/DESIGN.md: final v1 keyword set (6, engine-b ids) per critic sign-off The critic signed off on the 6-keyword set on #1 at 03:59:40Z, superseding the 9-set notes. - s10.1-10.2: viral, rising, local, encyclopedic, nostalgic, translated; edition/obscure/wildcard mode-only; keywordParams defaults incl. powerDelta - s12: 6-set worked example (critic-verified): T1 19-15, T2 15-19, T3 13-10, p0 wins; Main Page applies at scoring - s1.7/1.8 rarity cosmetic; s9 keywordsEnabled; s11 ranges - critic nits: s3 faction line, s8 'All one faction' row, s1.5 line Keeps from 21ee4be: portalParams, Featured Article tie, Big Board tablet, No Keywords array. Refs #1. Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 222 ++++++++++++++++++++++---------------------- 1 file changed, 109 insertions(+), 113 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 64104bc..11cd6ba 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -88,7 +88,7 @@ big cards are flexible. ### 1.5 Faction `faction` = the card's `category` (Space, Nature, People, Science, History, Culture), from `server/wiki.ts`. Culture is about half the pool, so faction keywords are written so that a -mono-faction deck gains no consistency edge (see §10, and `factionSynergyCap` in §9). +mono-faction deck gains no consistency edge (§10: no v1 keyword scales with faction count). ### 1.6 Trend (live, small, capped) `trend` = +1 if `live.trendPercent ≥ trendUp` (default 25), −1 if `≤ trendDown` (default −25), @@ -97,13 +97,11 @@ otherwise 0. A `null` value gives 0. Trend also needs `live.dailyAverage ≥ tre the match. It shows as an arrow (▲/▼), not a number. It adds to power in every Topic. ### 1.7 Rarity -The hash-derived `rarity` (`shared/protocol.ts:38`) sets the frame colour, and **it chooses the -keyword source, not power** (§10.1: a Common gets its home-stat keyword, a Rare or better gets its -faction keyword). Mining luck must not become power. +The hash-derived `rarity` (`shared/protocol.ts:38`) is **cosmetic in v1** (frame colour only). Mining luck must not +become power or keyword choice. ### 1.8 Keyword -Each card has at most **one** keyword, chosen deterministically from faction, home stat and rarity by -the table in §10 (owned by designer B). +Each card has at most **one** keyword: cost-1 cards are vanilla, and the others get their faction's keyword (§10.1). ### 1.9 Card face (phone) The card face shows **cost** (top-left), **power** (big, centre; the bonus shows as a "+N" badge on the home icon when the card is on-topic), a **home-stat icon** @@ -156,8 +154,7 @@ The engine does no I/O and only ever sees one version of each card. - 3 **Topics** (lanes), numbered 1–3 from left to right (top to bottom in portrait). - Each Topic has a **stat** (attention, depth or reach) and an optional **Portal** modifier (§10.3). - Topics have **no faction**. Faction matters only through keywords such as Rally, which count cards, - never Topics. + Topics have **no faction**. No v1 keyword counts factions: faction only picks the keyword. - Each player has at most `laneCapacity` cards per Topic (default **3**). That gives 9 slots per side, which caps cheap-card flooding and fits 3 cards across a 360 px phone. - **Topic pool:** `topicPool` is a list of Topics, each `{ id, name, stat, portal | null }`. The default @@ -268,7 +265,7 @@ the last turn's, and every "at scoring" Portal resolves **before** Topics are ju |---|---| | All-famous (all max-stat) deck | It becomes an all-cost-5/6 deck with dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**. Only 9 cards are seen per match (3 + 6 draws), so both matter. The 1-energy carry-over lets a heavy deck bank energy for a turn-5 six-drop. **sim-balance target: heavy vs curve ≥ 40%.** | | All-cheap flood (cost 1–2) | Weak by design: only 9 slots and 9 cards seen. Critic's sim under these rules: swarm vs curve about 7–11%. Its home is Culture's wide-turn keyword (§10). | -| All one faction | Faction synergies are capped (`factionSynergyCap`), and Culture is the largest pool but has the weakest synergy keywords (§10). | +| All one faction | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, has the weakest keyword (viral). | | "Always play the highest-power card" | It ignores the on-topic bonus, lane capacity and the hidden Portals. Critic's sim: 18–21% against a smart bot (target < 55%). | | Stall or pass | Passing leaves lanes to any 1-power card. Two passing players draw. | | Mirror the AI | Hidden simultaneous commits: you only see the opponent's cards after you commit. | @@ -297,7 +294,7 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D "costThresholds": [15, 35, 55, 75, 90], "powerByCost": [0, 1, 2, 4, 6, 8, 10], "onTopicBonus": [0, 1, 1, 2, 2, 3, 3], "vanillaBonus": 1, - "keywordsEnabled": ["Buzz","Anchor","Echo","Orbit","Grow","Rally","Research","Legacy","Remix"], "ownedCards": true, + "keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "ownedCards": true, "trendUp": 25, "trendDown": -25, "trendMinDaily": 20, "uncheckedCostCap": 4, "factionSynergyCap": 3, "verifyStats": true, @@ -317,76 +314,64 @@ A mode must keep `turns × turnSeconds ≤ 240` so that matches stay within 3– ## 10. Keywords *(owner: council-designer-b)* +**The v1 keyword set is these six, one per faction.** The ids are the ones engine-b already uses on `night/engine/keywords`. +Topics carry only a **stat**, never a faction. Every keyword below that mentions a Topic keys off stats or board state. + ### 10.1 Which keyword a card gets -The keyword comes from the card's **rarity**, **home stat** and **faction**, using the first rule that matches: +First rule that matches: +1. `cost == 1` → **no keyword** (vanilla). The card gets +`vanillaBonus` power (default **1**), so a cost-1 card is 2. +2. `"edition"` is in `keywordsEnabled` (off by default) and the deck holds another card with the same `pageId` → **edition**. +3. Otherwise → the card's **faction keyword** from 10.2, if it's in `keywordsEnabled`. If not, the card is vanilla, *without* `vanillaBonus`. -1. `cost == 1` → **no keyword**. Instead the card gets +`vanillaBonus` power (default **1**), so a cost-1 card has power 2. - Cheap cards stay simple, which helps new players. -2. `rarity == "Common"` → the **home-stat keyword** (Buzz, Anchor or Echo; table 10.2). -3. Otherwise (Rare, Epic or Legendary) → the **faction keyword** (table 10.2). +Rarity plays no part here (it's cosmetic, §1.7). Keywords don't lower power, and v1 has no per-keyword power deltas. +If sim shows that a keyword is worth more than about 1 power on average, sim-balance sets `keywordParams..powerDelta` (default 0, range −3 to 0). -This puts rarity to use, but only as *which* keyword a card has, never as how much power it has. Every keyword below is -worth about +1 to +3, which is the same as the trade-offs between home-stat keywords, so mining luck buys variety and not power. (This changes -§1.7 slightly. Designer-a, please note it there: "rarity chooses the keyword source, not power".) -Rough expected mix (with Common about 60%): about 15% vanilla, about 50% home-stat keywords, about 35% faction keywords. +### 10.2 Keyword list (v1) -Keywords are **one word** on the card face, plus one line of reminder text in the tap-to-inspect sheet. -They only ever *add* power (v1 has no removal, stealing, moving or lowering power). "Here" means this card's Topic, and -"your" means the owner's side. An effect stops at its cap, so no keyword moves a lane by more than 3 (§8 requires 6 or less). +| Faction | id (card word) | Trigger | Reminder text | Cap | Order-sensitive? | +|---|---|---|---|---|---| +| Culture | **viral** | On reveal | +1 power for each other card you revealed earlier this turn. | +2 | yes: your queue order | +| Nature | **rising** | End of turn | +1 power. | +2 total | no | +| People | **local** | Ongoing | +1 power while on-topic (the Topic's stat is its home stat). | +1 | no | +| Science | **encyclopedic** | On reveal | +2 power if there are no other cards here (either side). | +2 | **yes: interleaving** | +| History | **nostalgic** | On reveal | +2 power if you are losing here. | +2 | **yes: interleaving** | +| Space | **translated** | On reveal | +1 power to your most recently revealed card in each *other* Topic. | +2 | yes | -### 10.2 Keyword list - -| Keyword | Source | Trigger | Reminder text | Cap | -|---|---|---|---|---| -| **Buzz** | home: attention | On reveal | +1 power to each of your *other* cards here. | +2 (lane cap 3) | -| **Anchor** | home: depth | Ongoing | +2 power while it is your only card here. | +2 | -| **Echo** | home: reach | On reveal | +1 power to your most recently played card in each *other* Topic. | +2 (2 cards) | -| **Orbit** | faction: Space | Ongoing | +1 to your Topic power in each *adjacent* Topic. | +1 per adjacent Topic | -| **Grow** | faction: Nature | End of turn | +1 power. | +3 total | -| **Rally** | faction: People | On reveal | +1 power to each of your *other People* cards, in any Topic. | `factionSynergyCap` (3) | -| **Research** | faction: Science | On reveal | +1 power for each Topic you lead right now. | +3 | -| **Legacy** | faction: History | Ongoing | On the last turn, +2 power if this card has been here since turn 4 or earlier. | +2 | -| **Remix** | faction: Culture | On reveal | +2 power if you are losing here. | +2 | +Why this set: every keyword is one line and one trigger, and only adds power. The largest swing is +2 on one card, +so no lane moves by more than 2 from a keyword. Nothing scales with faction count, so a mono-Culture deck gets no +consistency edge (`factionSynergyCap` is unused in v1). Viral is Culture's weakest keyword, and it rewards wide turns. +Three keywords (encyclopedic, nostalgic, translated) react to the interleaved reveal (§5.4), so initiative and queue order matter. Precise rules (for engine-b): -- **On reveal** resolves when this card enters its Topic during Reveal (§5.4). It sees every card already revealed, - including cards the initiative player revealed earlier in the same turn. Bonuses it grants are permanent power counters on the target cards. -- **Ongoing** is recalculated every time Topic power is read. It's a condition, not a counter. -- **End of turn** resolves in §5.5 order: the initiative player's cards first, then Topic 1→3, then play order. -- **Buzz** targets only cards already here when it reveals. Cards that arrive later don't get the bonus. -- **Anchor** counts only its owner's cards here. Opposing cards don't matter. -- **Echo:** "most recently played" means the highest play sequence number among your cards in that Topic. Topics where you have no card are skipped. -- **Orbit** adds to Topic power, not to a card. It works even if you have no cards in the adjacent Topic (so Topic power can go 0 → 1). - Topic 2 is adjacent to 1 and 3. Topics 1 and 3 are adjacent only to 2. -- **Grow** stops after it has gained +3 in total. -- **Rally** counts cards by faction. Wildcard-style faction changes don't exist in v1. It gives at most `factionSynergyCap` counters in total, - going to the targets in play order. -- **Research** counts Topics where you lead (strictly greater Topic power) at the moment it resolves, including this - Topic after its own base and on-topic power is added. *(Clarification: the card's own power counts toward leading here.)* -- **Legacy** applies when `turn == turns` (the last turn), from the start of that turn, and only if the card was revealed on a turn ≤ `keywordParams.Legacy.byTurn` (default **4**, i.e. `turns − 2`). So committing a History card early is a real choice: it shows your hand to win the +2. -- **End-of-turn effects on the last turn resolve before scoring** (§7), so Grow's last +1 counts. -- **Remix:** "losing here" means the opponent's Topic power here is strictly greater than yours, counted just *before* this card - is added. -- **Culture is about half the pool,** so its faction keyword (Remix) is the one with no faction synergy. A Culture-heavy deck - gets no consistency bonus from being mono-faction. Only People (Rally) has faction synergy, and it's capped. +- **On reveal** resolves the moment the card enters its Topic, and sees every card revealed before it (both players, + including earlier reveals this turn). The bonuses it grants are permanent counters. +- **Ongoing** is a condition, recalculated whenever power is read. +- **End of turn** resolves in §5.5 order: the initiative player's cards first, then Topic 1→3, then reveal order. +- **viral:** counts the owner's cards revealed earlier in *this* turn's Reveal phase, in any Topic. Cards that went back to hand don't count. +- **rising:** stops after it has gained +2 in total. +- **local:** "on-topic" is exactly the §1.4/§6 condition. It's simply an extra +1 on top of `onTopicBonus`. +- **encyclopedic:** "no other cards here" means both sides of this Topic are empty, apart from this card, when it reveals. +- **nostalgic:** "losing here" means the opponent's Topic power here is strictly greater than yours, counted just *before* this card is added. + The consensus tie-break doesn't count: a tie is not losing. +- **translated:** "most recently revealed" means the highest global reveal sequence number among your cards in that Topic. Topics where you have no card are skipped. +- No v1 keyword uses the RNG. §4's "later random events" slot stays empty in v1. -Examples: -- *Buzz:* you have Haiku (2) and Jazz (4) in Topic 2, then play Pop music (Buzz, power 5). Haiku becomes 3, Jazz 5, and Pop music stays 5. -- *Anchor:* Coral reef (power 2) alone in Topic 1 is 4. Once you add another card there, it's 2 again. -- *Echo:* Moon is revealed in Topic 3. Your last card in Topic 1 gets +1. You have nothing in Topic 2, so that part is skipped. -- *Orbit:* Jupiter is in Topic 3, so your Topic 2 power is +1 even though no card there changed. -- *Rally:* Albert Einstein is revealed with no other People cards in play, so nothing happens. With Marie Curie and Ada Lovelace in play, each gets +1. -- *Research:* you lead Topics 1 and 3 when Periodic table is revealed into Topic 1, so it gets +2. -- *Legacy:* Ancient Rome (power 7) shows 7 on turns 5 and 9 on turn 6. -- *Remix:* the opponent has 6 here and you have 3, so Jazz (power 2) is revealed as 4. +**Already in code, disabled by default (`keywordsEnabled` excludes them; for modes only):** +- **edition:** +2 for each other copy of this `pageId` on your side. +- **obscure:** the opponent sees it face down until the end of the match. +- **wildcard:** its home stat becomes the Topic's stat on reveal. -**`keywordParams` defaults** (every number above, keyed by keyword id; modes may change them within 0–6): +These are engine-b's existing implementations. The faction-based versions of `local` and `wildcard`, and the token version of `viral`, are +**replaced** by the definitions above. + +**`keywordParams` defaults** (keyed by keyword id; modes may change them within the §11 ranges): ```json -{ "Buzz": {"amount": 1, "cap": 2}, "Anchor": {"amount": 2}, "Echo": {"amount": 1}, - "Orbit": {"amount": 1}, "Grow": {"amount": 1, "cap": 3}, "Rally": {"amount": 1, "cap": 3}, - "Research": {"amount": 1, "cap": 3}, "Legacy": {"amount": 2, "byTurn": 4}, "Remix": {"amount": 2} } +{ "viral": {"amount": 1, "cap": 2, "powerDelta": 0}, "rising": {"amount": 1, "cap": 2, "powerDelta": 0}, + "local": {"amount": 1, "powerDelta": 0}, "encyclopedic": {"amount": 2, "powerDelta": 0}, + "nostalgic": {"amount": 2, "powerDelta": 0}, "translated": {"amount": 1, "powerDelta": 0}, + "edition": {"amount": 2, "powerDelta": 0}, "obscure": {"powerDelta": 0}, "wildcard": {"powerDelta": 0} } ``` -Rally's cap is `factionSynergyCap` when that key is set. Otherwise it's `keywordParams.Rally.cap`. +End-of-turn effects on the last turn resolve **before** scoring (§7). ### 10.3 Portals (Topic modifiers) and the default Topic pool Each Topic has `{ id, name, stat, portal | null }`. The default `topicPool` has 9 Topics, one plain and two with @@ -412,7 +397,6 @@ As data: `portal = { kind: "scoringCardBonus", amount: 1 } | { kind: "trendMulti "featured-article": {"amount": 2}, "stub": {"value": 2}, "interwiki": {"amount": 1} }`. Disambiguation has no numbers. Topic ids are the names in kebab-case: `current-events, main-page, trending, archive, featured-article, stub, translations, interwiki, disambiguation`. The UI shows each Portal's one-line rule **on the lane itself**, not behind a tap. -Orbit's bonus is not on any card, so the UI shows it as a lane badge ("+1 🪐") next to the Topic total. --- @@ -447,8 +431,8 @@ A **mode** is data, published by a node operator and run by the match host: | `onTopicBonus` (7 entries), `vanillaBonus` | 0–5 each | | `trendUp` / `trendDown` | 0–200 / −200–0 | | `factionSynergyCap` | 0–6 | -| `keywordsEnabled` | any subset of the 9 v1 keywords; a disabled keyword makes those cards vanilla, *without* `vanillaBonus` | -| `keywordParams`, `portalParams` | only the keys listed in §10.2 / §10.3, each in 0–6 (`Legacy.byTurn` in 1..`turns`) | +| `keywordsEnabled` | any subset of the 9 implemented ids (the 6 v1 defaults + edition, obscure, wildcard); a card whose keyword is disabled is vanilla, *without* `vanillaBonus` | +| `keywordParams`, `portalParams` | only the keys listed in §10 / §10.3; amounts and caps 0–6, `powerDelta` −3–0 | | `verifyStats` | the host may only turn this off for modes that use only loaners (`maxLoaners == deckSize` and owned cards banned) | | `topicPool` | 3–20 Topics, Portal kinds only from 10.3 | @@ -471,52 +455,64 @@ Example modes (good defaults for operators to publish): ## 12. Worked example match *(owner: council-designer-b)* -This example uses the §1–11 rules of this PR. It was recomputed by council-critic (who checked it with a script) and re-checked by hand by designer-b. -- **Rules:** `powerByCost [0,1,2,4,6,8,10]`, `onTopicBonus [0,1,1,2,2,3,3]`, `vanillaBonus 1`, `laneCapacity 3`, - interleaved reveals, `underdog false`, no trend arrows. Nobody carries energy: both players spend 1/2/3/4/5/6. -- **Initiative:** Ana (p0) on odd turns, Bo (p1) on even turns. -- **Topics:** **T1 Archive (depth, plain)**, **T2 Main Page (attention; Portal revealed turn 3; at scoring, +1 per card here)**, - **T3 Translations (reach, plain)**. +These are the §1–9 rules as of this PR: +- `powerByCost [0,1,2,4,6,8,10]`, `onTopicBonus [0,1,1,2,2,3,3]`, `vanillaBonus 1` +- `laneCapacity 3`, `energyCarryMax 1`, interleaved reveals, alternating initiative, `portalReveal [2,3,4]` +- `underdog false`, no trend arrows -The cards are the §1 output, given directly. "Base" is `powerByCost[cost]`, with +1 for cost-1 vanilla cards; "+on" is `onTopicBonus[cost]`. +The derived cards are given directly (the §1 output), so the test needs no percentile table. +Topics: **T1 Archive (depth, plain)**, **T2 Main Page (attention; Portal revealed turn 3; at scoring, each card here gets +1)**, +**T3 Translations (reach, plain; revealed turn 4)**. Ana (p0) has initiative on odd turns and Bo (p1) on even turns. -| Player | Card | Faction / rarity | Cost | Base (+on) | Home | Keyword | +| Player | Card | Faction | Cost | Base | Home | Keyword | |---|---|---|---|---|---|---| -| Ana | Octopus | Nature / Common | 1 | 2 (+1) | depth | – (vanilla) | -| Ana | Moon | Space / Common | 2 | 2 (+1) | reach | Echo | -| Ana | Periodic table | Science / Rare | 3 | 4 (+2) | depth | Research | -| Ana | Albert Einstein | People / Epic | 4 | 6 (+2) | attention | Rally | -| Ana | Ancient Rome | History / Rare | 5 | 8 (+3) | depth | Legacy | -| Ana | Library of Alexandria | History / Common | 4 | 6 (+2) | depth | Anchor | -| Ana | Coral reef | Nature / Common | 2 | 2 (+1) | depth | Anchor | -| Bo | Haiku | Culture / Common | 1 | 2 (+1) | attention | – (vanilla) | -| Bo | Jazz | Culture / Rare | 2 | 2 (+1) | attention | Remix | -| Bo | Fern | Nature / Rare | 3 | 4 (+2) | depth | Grow | -| Bo | Pop music | Culture / Common | 4 | 6 (+2) | attention | Buzz | -| Bo | Jupiter | Space / Epic | 5 | 8 (+3) | reach | Orbit | -| Bo | Saturn | Space / Legendary | 6 | 10 (+3) | reach | Orbit | +| Ana | Octopus | Nature | 1 | 2 | depth | – (vanilla) | +| Ana | Moon | Space | 2 | 2 | reach | translated | +| Ana | Coral reef | Nature | 2 | 2 | depth | rising | +| Ana | Albert Einstein | People | 4 | 6 | attention | local | +| Ana | Ancient Rome | History | 5 | 8 | depth | nostalgic | +| Ana | Library of Alexandria | History | 4 | 6 | depth | nostalgic | +| Ana | Periodic table | Science | 3 | 4 | depth | encyclopedic | +| Bo | Haiku | Culture | 1 | 2 | attention | – (vanilla) | +| Bo | Mars | Space | 2 | 2 | reach | translated | +| Bo | Jazz | Culture | 2 | 2 | attention | viral | +| Bo | Pop music | Culture | 4 | 6 | attention | viral | +| Bo | Jupiter | Space | 5 | 8 | reach | translated | +| Bo | Fern | Nature | 3 | 4 | depth | rising | +| Bo | Mona Lisa | Culture | 3 | 4 | attention | viral | -Topic power is written as **Ana–Bo** after the End phase. +Topic power is written as **Ana–Bo** after End of turn. Energy is "available / spent". -| Turn | Initiative | Reveals (interleaved order) and effects | T1 | T2 | T3 | -|---|---|---|---|---|---| -| 1 | Ana | Ana Octopus → T1: 2+1 = **3**. Bo Haiku → T1: **2** (off-topic) | 3–2 | 0–0 | 0–0 | -| 2 | Bo | Bo Jazz → T2: 2+1 = 3. Remix: not losing (0–0), so no bonus. Ana Moon → T3: 2+1 = 3. Echo: Octopus +1 → 4 | 4–2 | 0–3 | 3–0 | -| 3 | Ana | Main Page Portal revealed. Ana Periodic table → T1: 4+2 = 6. Research: Ana leads T1 (10–2) and T3 (3–0), so +2 → **8**. Bo Fern → T1: 4+2 = 6. End, Grow: Fern 7 | 12–9 | 0–3 | 3–0 | -| 4 | Bo | Bo Pop music → T2: 6+2 = 8. Buzz: Jazz +1 → 4. Ana Einstein → T2: 6+2 = 8. Rally: no other People cards. End, Grow: Fern 8 | 12–10 | 8–12 | 3–0 | -| 5 | Ana | Ana Ancient Rome → T3: 8 (depth ≠ reach). Its Legacy can't apply, because it arrived on turn 5 > 4. Bo Jupiter → T3: 8+3 = 11. Orbit: Bo's T2 +1. End, Grow: Fern 9 (the +3 cap is reached) | 12–11 | 8–13 | 11–11 | -| 6 (last) | Bo | Bo Saturn → T3: 10+3 = 13. Orbit: Bo's T2 +1. Ana Library → T3: 6 (off-topic; Anchor no, not alone). Ana Coral reef → T1: 2+1 = 3 (Anchor no). Scoring: Main Page gives +1 per card in T2 | **15–11** | **9–16** | **17–24** | +| Turn | Init | Energy Ana / Bo | Reveals, in interleaved order | T1 | T2 | T3 | +|---|---|---|---|---|---|---| +| 1 | Ana | 1/1, 1/1 | Ana Octopus → T1: 2 +1 on-topic = **3**. Bo Haiku → T2: 2+1 = **3** | 3–0 | 0–3 | 0–0 | +| 2 | Bo | 2/2, 2/0 | Bo passes (to carry 1). Ana Moon → T3: 2+1 = 3. translated: Octopus +1 → 4 | 4–0 | 0–3 | 3–0 | +| 3 | Ana | 3/2, **4**/4 | Main Page Portal revealed. Ana Coral reef → T1: 2+1 = 3. Bo Mars → T3: 2+1 = 3, translated: Haiku +1 → 4. Bo Jazz → T2: 2+1 = 3, viral (Mars earlier) +1 → 4. End: rising Coral reef → 4 | 8–0 | 0–8 | 3–3 (tie; on-topic 1–1, so no leader) | +| 4 | Bo | **5**/4, 4/4 | Bo Pop music → T3: 6 (off-topic), viral +0. Ana Einstein → T2: 6+2 on-topic, local +1 = **9**. End: rising Coral reef → 5 (cap reached) | 9–0 | 9–8 | 3–9 | +| 5 | Ana | **6**/5, 5/5 | Ana Ancient Rome → T3: 8 (off-topic). nostalgic: losing 3–9, so +2 → **10**. Bo Jupiter → T1: 8 (off-topic). translated: Jazz → 5 (T2), Pop music → 7 (T3) | 9–8 | 9–9: **Bo leads** (consensus: on-topic 1 vs 2) | 13–10 | +| 6 (last) | Bo | **7**/7, 6/6 | Bo Fern → T1: 4+2 = 6. Ana Library → T1: 6+2 = 8. nostalgic: losing 9–14, so +2 → **10**. Bo Mona Lisa → T2: 4+2 = 6, viral (Fern earlier) +1 → 7. Ana Periodic table → T2: 4 (off-topic), encyclopedic: no (cards here). End: rising Fern → 7. Scoring: Main Page +1 per card in T2 | **19–15** | **15–19** | **13–10** | -Final board: -- **T1:** Ana has Octopus 4 + Periodic table 8 + Coral reef 3 = **15**. Bo has Haiku 2 + Fern 9 = **11**. → Ana -- **T2:** Ana has Einstein 8+1 = **9**. Bo has Jazz 4+1 + Pop music 8+1 + Orbit ×2 = **16**. → Bo -- **T3:** Ana has Moon 3 + Ancient Rome 8 + Library 6 = **17**. Bo has Jupiter 11 + Saturn 13 = **24**. → Bo +Final card values: +- **T1:** + - Ana: Octopus 4 + Coral reef 5 + Library 10 = 19. + - Bo: Jupiter 8 + Fern 7 = 15. +- **T2:** each card +1 from Main Page. + - Ana: Einstein 10 + Periodic table 5 = 15. + - Bo: Haiku 5 + Jazz 6 + Mona Lisa 8 = 19. +- **T3:** + - Ana: Moon 3 + Ancient Rome 10 = 13. + - Bo: Mars 3 + Pop music 7 = 10. -**Bo wins 2–1** (total power 41–51; the tie-break isn't needed). -The deciding moment was Ana's turn-5 Rome. It was off-topic in T3, and too late for Legacy. Saturn on-topic plus a second Orbit then took both T2 and T3. +**Ana wins 2–1.** Three moments show the v1 mechanics: +- **Carry-over:** Bo passed on turn 2 to afford two plays on turn 3 (4 energy). +- **Consensus:** T2 at 9–9 after turn 5 went to Bo, who had two on-topic attention cards to Ana's one. +- **Interleaving decides the match:** on turn 6 Bo had initiative, so Fern revealed before Library. Ana was then losing T1 (9 vs 14) and nostalgic fired (+2). + If Ana had revealed first, she'd have been ahead 9–8, nostalgic would not have fired, and T1 would have been 17–15. Ana still wins that lane, but by 2 instead of 4. -**Golden test (engine-b):** -- **Inject:** the Topic order, these 13 cards and these commit lists, in the queue order shown. -- **Expected final Topic powers:** `[[15,11],[9,16],[17,24]]` (Ana–Bo). Winner: p1. -- **Coverage:** vanilla, Echo, Research, Grow (including its cap), Buzz, Orbit ×2, the Main Page Portal at scoring, and Remix, Rally, Anchor and Legacy correctly **not** firing. -- **Separate unit tests:** add cases where Remix, Rally, Anchor and Legacy (here since turn ≤ 4) **do** fire. +**Golden test for engine-b:** +- **Inject:** the Topic order, the opening hands and the draw order directly, with each player's commit list per turn as in the table. The queue order within a turn is as listed. +- **Expected final Topic powers:** `T1 19–15, T2 15–19, T3 13–10`. Winner: p0, by 2 Topics to 1. +- **Also assert:** + - after turn 5, T2 is a 9–9 tie with Bo leading by consensus + - Ana's carried energy is 1 at the start of turns 4, 5 and 6 + - Bo's carried energy is 1 at the start of turn 3 -- 2.54.0 From 3e80ae4c154d6422f9257e482fe42b7d38e485b4 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:03:45 -0500 Subject: [PATCH 2/4] docs/game/DESIGN.md: s2.1 starter decks v1 (4 loaner decks, pinned values) Four 12-card loaner decks (Stargazers, Field Guide, Headliners, Pioneers): identical curve 1,1,2,2,3,3,3,4,4,5,5,6, two factions x6, homes 4/4/4, all 6 factions and all 4 catalog cards covered. Loaners carry pinned {cost, home, faction} (CardInput.pinned) until council-data's starter-cards.json exists; everything downstream (powerByCost, on-topic, keywords) still comes from the rules config. Refs #1. Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 90 ++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 88 insertions(+), 2 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 11cd6ba..03341f8 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -52,7 +52,8 @@ The engine never reads raw 0–100 stats as power. Every game card is derived ** CardInput = { cardId, pageId, title, category, rarity, snapshot: MintStatsSnapshot, // at mint, immutable live: { trendPercent: number | null, dailyAverage: number | null }, // frozen at match start - check: 'verified' | 'unverified' | 'unchecked' | 'loaner' } // set by the host (§1.10) + check: 'verified' | 'unverified' | 'unchecked' | 'loaner', // set by the host (§1.10) + pinned?: { cost, home, faction } } // loaners only (§2.1): replaces §1.1–1.5 ``` ### 1.1 Percentiles (rank-normalisation) @@ -140,7 +141,7 @@ The engine does no I/O and only ever sees one version of each card. - **Loaner cards:** off-chain preview cards with a fixed `CardInput`, shipped with the game data (`docs/game/starter-cards.json`, picked by council-data: about 24 pageIds across all 6 categories, with frozen, hand-checked snapshot stats, including the 4 cards in `shared/catalog.ts`). - Loaners follow the same derivation, so they are no weaker or stronger than owned cards. + Loaners follow the same curve (§2.1 pins their cost, home and faction), so they are no weaker or stronger than owned cards. - **Starter decks:** `starterDecks` (default: 4 fixed 12-card loaner decks). Each one has two leading factions and an average cost of 3.0–3.3, and is **curve-shaped**: at least 3 cards of cost 4 or more, and at most 4 of cost 1. A new player picks one and can play at once. @@ -148,6 +149,91 @@ The engine does no I/O and only ever sees one version of each card. means no limit). Owning NFTs gives **variety**, not power: owned and loaner cards follow the same curve. +### 2.1 Starter decks v1 *(owner: council-designer-b)* + +These are the default `starterDecks`: four 12-card loaner decks. +- **Every deck has the same curve:** costs `1,1,2,2,3,3,3,4,4,5,5,6`. That's an average of 3.25, with 5 cards of cost 4 or more and 2 of cost 1. +- **Every deck has the same shape:** 6 cards from each of two factions, and 4 cards for each home stat. So every deck can play on-topic in every lane. +- **Loaner values are pinned.** council-data's percentile table and `starter-cards.json` don't exist yet, so a loaner carries + `pinned: { cost, home, faction }`. For `check: 'loaner'` the engine takes these instead of §1.1–1.5. + Everything after them still applies: `powerByCost`, `onTopicBonus`, `vanillaBonus`, the §10.1 keyword choice and `keywordParams`. + A mode that changes those numbers changes loaners exactly as it changes owned cards. +- **Pinned cost isn't fame.** Cost was set by hand to fit the curve, not from the article's fame. Rarity is `Common` (frame only) and trend is 0. +- **Loaner ids:** `cardId` = `loaner:`, and `pageId` = the article's real pageId if the UI has it, otherwise `null`. Copies are counted per `cardId`. +- **Later:** if council-data later publishes `starter-cards.json` with real snapshots, it may replace these values in v1.1. + It must keep the same curve and home-stat spread. + +Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword (shown in brackets). + +**A. Stargazers: Space (translated) + Science (encyclopedic)** +| Cost | Card | Faction | Home | +|---|---|---|---| +| 1 | Moon | Space | reach | +| 1 | Electron | Science | depth | +| 2 | Mars | Space | attention | +| 2 | Periodic table | Science | depth | +| 3 | Saturn | Space | reach | +| 3 | Photosynthesis | Science | attention | +| 3 | Black hole | Space | depth | +| 4 | Quantum mechanics | Science | reach | +| 4 | Milky Way | Space | attention | +| 5 | DNA | Science | attention | +| 5 | Sun | Space | reach | +| 6 | Theory of relativity | Science | depth | + +**B. Field Guide: Nature (rising) + History (nostalgic)** +| Cost | Card | Faction | Home | +|---|---|---|---| +| 1 | Octopus | Nature | depth | +| 1 | Stonehenge | History | attention | +| 2 | Axolotl | Nature | attention | +| 2 | Rosetta Stone | History | reach | +| 3 | Coral reef | Nature | depth | +| 3 | Roman Empire | History | reach | +| 3 | Honey bee | Nature | attention | +| 4 | Ancient Egypt | History | depth | +| 4 | Amazon rainforest | Nature | reach | +| 5 | Blue whale | Nature | attention | +| 5 | Great Wall of China | History | reach | +| 6 | World War II | History | depth | + +**C. Headliners: People (local) + Culture (viral)** +| Cost | Card | Faction | Home | +|---|---|---|---| +| 1 | Haiku | Culture | attention | +| 1 | Ada Lovelace | People | depth | +| 2 | Jazz | Culture | attention | +| 2 | Marie Curie | People | reach | +| 3 | Mona Lisa | Culture | reach | +| 3 | Frida Kahlo | People | attention | +| 3 | Chess | Culture | depth | +| 4 | Leonardo da Vinci | People | reach | +| 4 | The Beatles | Culture | attention | +| 5 | William Shakespeare | People | depth | +| 5 | Olympic Games | Culture | reach | +| 6 | Wolfgang Amadeus Mozart | People | depth | + +**D. Pioneers: People (local) + Space (translated)** +| Cost | Card | Faction | Home | +|---|---|---|---| +| 1 | Sputnik 1 | Space | reach | +| 1 | Nikola Tesla | People | attention | +| 2 | Hubble Space Telescope | Space | depth | +| 2 | Isaac Newton | People | reach | +| 3 | Neil Armstrong | People | attention | +| 3 | Jupiter | Space | reach | +| 3 | Galileo Galilei | People | depth | +| 4 | Albert Einstein | People | attention | +| 4 | International Space Station | Space | depth | +| 5 | Apollo 11 | Space | attention | +| 5 | Charles Darwin | People | reach | +| 6 | Solar System | Space | depth | + +- **Coverage:** all 6 factions appear, and all 4 `shared/catalog.ts` cards are included (Moon, Periodic table, Octopus, Albert Einstein). +- **Tutorial:** Field Guide vs Stargazers, seed 1, against the easy bot. +- **sim-balance:** please run the 4 decks round robin first. The target is every pairing at 45–55%. If a pairing misses, retune by + swapping home stats within a deck, never by changing the curve. + --- ## 3. Board -- 2.54.0 From 385120babe87127127db4b93546f6a8bf84d0a73 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:07:27 -0500 Subject: [PATCH 3/4] docs/game/DESIGN.md: s2.1 relate starter decks to starter-cards.json; faction-skew note Refs #1. Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 03341f8..4e98e9d 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -160,8 +160,14 @@ These are the default `starterDecks`: four 12-card loaner decks. A mode that changes those numbers changes loaners exactly as it changes owned cards. - **Pinned cost isn't fame.** Cost was set by hand to fit the curve, not from the article's fame. Rarity is `Common` (frame only) and trend is 0. - **Loaner ids:** `cardId` = `loaner:`, and `pageId` = the article's real pageId if the UI has it, otherwise `null`. Copies are counted per `cardId`. -- **Later:** if council-data later publishes `starter-cards.json` with real snapshots, it may replace these values in v1.1. - It must keep the same curve and home-stat spread. +- **Relation to `docs/game/starter-cards.json`** (council-data, real frozen snapshots of random articles): that file is the + **loaner pool** for the sim and for "fill a slot with a loaner" in the deck builder. It is **not** the default starter decks. + The decks below pin their values on purpose, for two reasons. Famous, recognisable articles would all derive to cost 5–6. + And the random sample has no Space cards (CARD_DATA.md finding 6). +- **v1.1 note (factions):** CARD_DATA.md finding 6 shows the legacy `category()` split as Culture 53%, People 30%, Nature 9%, + History 5%, Science 3%, Space 0%. Owned decks will therefore be mostly viral and local. That's acceptable for v1, because + viral is the weakest keyword. The P31-based factions council-data proposes (People, Places, Nature, Works & Culture, + Structures, Events & Ideas) are the v2 fix, and would need the host to fetch P31 (it isn't in `PageEnrichment`). Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword (shown in brackets). -- 2.54.0 From 128b33a4ff9dc3dcf3cd0b8c8b5afe4bd3fee97f Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:10:03 -0500 Subject: [PATCH 4/4] docs/game/DESIGN.md: s2.1 fix faction-skew note (viral weakness hurts owned decks) Per critic on #1 (04:08Z). Refs #1. Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 4e98e9d..3340094 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -165,8 +165,10 @@ These are the default `starterDecks`: four 12-card loaner decks. The decks below pin their values on purpose, for two reasons. Famous, recognisable articles would all derive to cost 5–6. And the random sample has no Space cards (CARD_DATA.md finding 6). - **v1.1 note (factions):** CARD_DATA.md finding 6 shows the legacy `category()` split as Culture 53%, People 30%, Nature 9%, - History 5%, Science 3%, Space 0%. Owned decks will therefore be mostly viral and local. That's acceptable for v1, because - viral is the weakest keyword. The P31-based factions council-data proposes (People, Places, Nature, Works & Culture, + History 5%, Science 3%, Space 0%. Owned decks will therefore be about 50% viral and 30% local. Viral is the weakest keyword, so a typical owned deck + may be *weaker* than the starter decks. That's the wrong way round for "NFTs give variety, not power". v1 ships as is. + For v1.1, sim-balance runs a **realistic owned deck** (12 cards drawn from `card-sample.json` with its real category mix) + against each starter. If it wins under 45%, viral gets buffed first (e.g. cap 3, or a minimum of +1). The P31-based factions council-data proposes (People, Places, Nature, Works & Culture, Structures, Events & Ideas) are the v2 fix, and would need the host to fetch P31 (it isn't in `PageEnrichment`). Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword (shown in brackets). -- 2.54.0