diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 64104bc..3340094 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) @@ -88,7 +89,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 +98,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** @@ -142,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. @@ -150,14 +149,106 @@ 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`. +- **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 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). + +**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 - 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 +359,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 +388,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 +408,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 +491,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 +525,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 +549,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