From cf2fceb060716dad99216d0ab3aee4999c6546d4 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:01:28 -0500 Subject: [PATCH 01/13] 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 02/13] 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 03/13] 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 04/13] 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 From b7380eaec8cc50c1cd46480574d79ec753b8a542 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:12:56 -0500 Subject: [PATCH 05/13] docs/game/DESIGN.md: trendDown -200 (no down arrow in v1); loaner pageIds and copy rule Per council-critic on #1 (freeze items) and #18 review note 1. Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 3340094..090b52b 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -92,10 +92,12 @@ big cards are flexible. 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), +`trend` = +1 if `live.trendPercent ≥ trendUp` (default 25), −1 if `≤ trendDown` (default **−200**, i.e. off: there is no down arrow in v1), otherwise 0. A `null` value gives 0. Trend also needs `live.dailyAverage ≥ trendMinDaily` (default **20**), because percentages on tiny articles are noise; otherwise trend is 0. The host computes it **once at match start**, and it is frozen for -the match. It shows as an arrow (▲/▼), not a number. It adds to power in every Topic. +the match. It shows as an arrow (▲), not a number. It adds to power in every Topic. *Why no ▼ in v1:* 69% of the sample has a +negative `trendPercent`, and only busy (mostly owned, famous) cards pass `trendMinDaily`, so a ▼ would quietly penalise collectors. +Modes may turn it back on with e.g. `trendDown: -25`. ### 1.7 Rarity The hash-derived `rarity` (`shared/protocol.ts:38`) is **cosmetic in v1** (frame colour only). Mining luck must not @@ -159,7 +161,9 @@ These are the default `starterDecks`: four 12-card loaner decks. 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`. +- **Loaner ids:** `cardId` = `loaner:`, and `pageId` = the article's real pageId (v1 pins the 4 `shared/catalog.ts` ones: Moon 19331, Periodic table 23053, Octopus 22780, + Albert Einstein 736; the rest are filled in from one batched API call in v1.1, `null` until then). The copy limit counts per `pageId` + together with owned copies (§2); a loaner with `pageId: null` counts 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. @@ -389,7 +393,7 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D "powerByCost": [0, 1, 2, 4, 6, 8, 10], "onTopicBonus": [0, 1, 1, 2, 2, 3, 3], "vanillaBonus": 1, "keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "ownedCards": true, - "trendUp": 25, "trendDown": -25, "trendMinDaily": 20, "uncheckedCostCap": 4, + "trendUp": 25, "trendDown": -200, "trendMinDaily": 20, "uncheckedCostCap": 4, "factionSynergyCap": 3, "verifyStats": true, "percentiles": "card-sample-2026-11-16", -- 2.54.0 From 264acab8d20d475b5e461e78f57d5a2e03f0b265 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:35:30 -0500 Subject: [PATCH 06/13] docs/game/DESIGN.md: v1.1 draft (designer-b sections): viral base 1/cap 3, encyclopedic own side, Culture keyword by home stat, rising powerDelta -1 Pending sim-balance's balance report; numbers from council-critic's engine sim on #1. Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 48 +++++++++++++++++++++++++++++---------------- 1 file changed, 31 insertions(+), 17 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 8a11676..2030ab3 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -96,7 +96,9 @@ mono-faction deck gains no consistency edge (§10: no v1 keyword scales with fac which means there is **no down arrow in v1**: 69% of cards trend negative, so a ▼ would mostly land as a quiet penalty on famous owned cards; modes can turn it back on), otherwise 0. A `null` value gives 0. Trend also needs `live.dailyAverage ≥ trendMinDaily` (default **20**), because percentages on tiny articles are noise; otherwise trend is 0. The host computes it **once at match start**, and it is frozen for -the match. It shows as an arrow (▲/▼), not a number. It adds to power in every Topic. +the match. It shows as an arrow (▲), not a number. It adds to power in every Topic. *Why no ▼ by default:* 69% of the sample has a +negative `trendPercent`, and only busy (mostly owned, famous) cards pass `trendMinDaily`, so a ▼ would quietly penalise collectors. +Modes may turn it back on with e.g. `trendDown: -25`. ### 1.7 Rarity The hash-derived `rarity` (`shared/protocol.ts:38`) is **cosmetic in v1** (frame colour only). Mining luck must not @@ -155,7 +157,7 @@ The engine does no I/O and only ever sees one version of each card. 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 +- **Loaner values are pinned.** Cost, home and faction are hand-set (not derived from `starter-cards.json`), 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. @@ -168,10 +170,11 @@ 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 about 50% viral and 30% local. Viral is the weakest keyword, so a typical owned deck + History 5%, Science 3%, Space 0%. In v1, owned decks were therefore about 50% viral and 30% local. Viral was 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, + against each starter. **v1.1 fix:** viral gets a base of +1, and Culture cards take a keyword by home stat (§10.1), so owned decks + now have all six keywords in the mix (critic sim, #1: owned vs starters 46–52%). 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). @@ -208,7 +211,7 @@ Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword ( | 5 | Great Wall of China | History | reach | | 6 | World War II | History | depth | -**C. Headliners: People (local) + Culture (viral)** +**C. Headliners: People (local) + Culture (by home stat: attention → viral, depth → encyclopedic, reach → translated)** | Cost | Card | Faction | Home | |---|---|---|---| | 1 | Haiku | Culture | attention | @@ -362,7 +365,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. An all-cost-5/6 deck is **weak by design**: it has four dead turns (sim-balance interim: 0–15%). There is no hard deck rule in v1; the deck builder warns when a deck has fewer than 4 cards of cost ≤ 2, and every starter deck is curve-shaped (§2.1). **sim-balance target: a **top-heavy curve** (half the deck at cost 4 or more) vs curve ≥ 40%.** `energyByTurn [2..7]` is a v1.1 candidate. | | 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 | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, has the weakest keyword (viral). | +| All one faction | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, splits over three keywords by home stat (§10.1), so it has no single keyword to stack. | | "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. | @@ -391,7 +394,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": ["viral","rising","local","encyclopedic","nostalgic","translated"], "ownedCards": true, + "keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "cultureKeyword": "home", "ownedCards": true, "trendUp": 25, "trendDown": -200, "trendMinDaily": 20, "uncheckedCostCap": 4, "factionSynergyCap": 3, "verifyStats": true, @@ -418,7 +421,12 @@ Topics carry only a **stat**, never a faction. Every keyword below that mentions 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`. +3. If the faction is **Culture** and `cultureKeyword` is `"home"` (v1.1 default) → the keyword for its **home stat**: + attention → **viral**, depth → **encyclopedic**, reach → **translated**. (`"faction"` gives v1 behaviour: every Culture card is viral.) +4. Otherwise → the card's **faction keyword** from 10.2. + +In steps 3–4, if the chosen keyword isn't in `keywordsEnabled`, the card is vanilla, *without* `vanillaBonus`. +*Why step 3:* Culture is about half of all owned cards. Without it, owned decks are half viral and see only 2 of the 6 keywords. 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). @@ -427,16 +435,16 @@ If sim shows that a keyword is worth more than about 1 power on average, sim-bal | 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 | +| Culture | **viral** | On reveal | +1 power, plus +1 for each other card you revealed earlier this turn. | +3 | 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** | +| Science | **encyclopedic** | On reveal | +2 power if you have no other cards here. | +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 | 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. +so no lane moves by more than 3 from a keyword (viral at its cap). Nothing scales with faction count, so a mono-Culture deck gets no +consistency edge (`factionSynergyCap` is unused). Viral rewards wide turns, and Culture cards are spread over three keywords (§10.1 step 3). Three keywords (encyclopedic, nostalgic, translated) react to the interleaved reveal (§5.4), so initiative and queue order matter. Precise rules (for engine-b): @@ -444,10 +452,12 @@ Precise rules (for engine-b): 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. +- **viral:** gain = min(`base` + `amount` × N, `cap`), where N = the owner's cards revealed earlier in *this* turn's Reveal phase, in any Topic. + Cards that went back to hand don't count. v1.1: base 1, amount 1, cap 3 (v1 was base 0, cap 2). - **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. +- **encyclopedic:** with `sides: 1` (v1.1 default), "no other cards here" means **your** side of this Topic is empty, apart from this card, + when it reveals; the opponent's cards don't matter. `sides: 2` is v1 (both sides empty). - **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. @@ -463,8 +473,8 @@ These are engine-b's existing implementations. The faction-based versions of `lo **`keywordParams` defaults** (keyed by keyword id; modes may change them within the §11 ranges): ```json -{ "viral": {"amount": 1, "cap": 2, "powerDelta": 0}, "rising": {"amount": 1, "cap": 2, "powerDelta": 0}, - "local": {"amount": 1, "powerDelta": 0}, "encyclopedic": {"amount": 2, "powerDelta": 0}, +{ "viral": {"base": 1, "amount": 1, "cap": 3, "powerDelta": 0}, "rising": {"amount": 1, "cap": 2, "powerDelta": -1}, + "local": {"amount": 1, "powerDelta": 0}, "encyclopedic": {"amount": 2, "sides": 1, "powerDelta": 0}, "nostalgic": {"amount": 2, "powerDelta": 0}, "translated": {"amount": 1, "powerDelta": 0}, "edition": {"amount": 2, "powerDelta": 0}, "obscure": {"powerDelta": 0}, "wildcard": {"powerDelta": 0} } ``` @@ -529,7 +539,8 @@ A **mode** is data, published by a node operator and run by the match host: | `trendUp` / `trendDown` | 0–200 / −200–0 | | `factionSynergyCap` | 0–6 | | `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 | +| `keywordParams`, `portalParams` | only the keys listed in §10 / §10.3; amounts and caps 0–6, `viral.base` 0–3, `encyclopedic.sides` 1–2, `powerDelta` −3–0 | +| `cultureKeyword` | `"home"` or `"faction"` | | `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 | @@ -552,6 +563,9 @@ Example modes (good defaults for operators to publish): ## 12. Worked example match *(owner: council-designer-b)* +**Ruleset for this example: v1.0** (the golden test pins it): `cultureKeyword "faction"`, `viral {base 0, cap 2}`, +`encyclopedic {sides 2}`, `rising.powerDelta 0`; everything else as §9. *(v1.1 golden numbers: to be added once the engine has the v1.1 hooks.)* + 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]` -- 2.54.0 From 8137ea7cb17b9e5c067e6ce0b179643cb2c4356d Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:38:37 -0500 Subject: [PATCH 07/13] =?UTF-8?q?docs/game/DESIGN.md:=20v1.1=20=C2=A71.2?= =?UTF-8?q?=20costThresholds=20[26,39,51,63,78]=20from=20sample=20fame=20q?= =?UTF-8?q?uantiles;=20version=201.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 2030ab3..2a7f335 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -66,9 +66,15 @@ down. A `null` attention gives `pct_attention = null`. ### 1.2 Fame → Cost `fame` = the integer mean (rounded half up) of the non-null percentiles. `cost` = 1 + the number of thresholds in `costThresholds` (5 ascending values, default -`[15, 35, 55, 75, 90]`) that are ≤ `fame`. So cost runs 1–6. -The defaults aim at a pool cost spread of about 15/20/20/20/15/10 %. They are retuned from the -sample's fame distribution. +`[26, 39, 51, 63, 78]` in v1.1) that are ≤ `fame`. So cost runs 1–6. +**Thresholds are data, not guesses (v1.1).** `fame` is a *mean* of up to 3 percentiles, so it clusters +around 50 even though each percentile is uniform. The v1.0 values `[15, 35, 55, 75, 90]` treated fame as +uniform, so 82% of the pool landed on cost 2–4 (3/23/37/22/10/5 %). `costThresholds` is therefore set to +the fame values at the **15/35/55/75/90 % points of the reference sample** (the same `card-sample.json` +whose `percentiles` table §1.1 uses). That's the integer set that brings the sample's cost spread closest +to the target 15/20/20/20/15/10 %. The v1.1 defaults come from the 236-card sample (fame 8–98) and +give 13/20/22/20/15/10 %. Whenever council-data refreshes the sample, the percentile table and +`costThresholds` are regenerated together and ship as one change. Pinned loaners (§2.1) are unaffected. ### 1.3 Power `power` = `powerByCost[cost]`, default `[_, 1, 2, 4, 6, 8, 10]` (cost 1 → 1 … cost 6 → 10). The @@ -382,7 +388,7 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D ```json { - "version": "1.0", + "version": "1.1", "deckSize": 12, "maxCopiesPerPage": 2, "maxLoaners": 12, "openingHand": 3, "handLimit": 7, "mulligan": false, "turns": 6, "turnSeconds": 25, "afkTurns": 2, @@ -391,7 +397,7 @@ The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). D "topicPool": [ /* inline Topic objects {id, name, stat, portal}; default = the 9 in §10.3 */ ], "keywordParams": { /* per-keyword numbers, keyed by keyword id (§10) */ }, "portalParams": { /* per-Portal numbers, keyed by Topic id (§10.3) */ }, - "costThresholds": [15, 35, 55, 75, 90], + "costThresholds": [26, 39, 51, 63, 78], "powerByCost": [0, 1, 2, 4, 6, 8, 10], "onTopicBonus": [0, 1, 1, 2, 2, 3, 3], "vanillaBonus": 1, "keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "cultureKeyword": "home", "ownedCards": true, -- 2.54.0 From 026af9e78e37d6867b8c357c3f83e3813b49cbbc Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:46:40 -0500 Subject: [PATCH 08/13] =?UTF-8?q?docs/game/DESIGN.md:=20=C2=A712.1=20worke?= =?UTF-8?q?d=20example=20under=20the=20v1.1=20ruleset=20(golden=20[[18,14]?= =?UTF-8?q?,[15,21],[13,11]])?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 2a7f335..ad1d746 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -633,3 +633,32 @@ Final card values: - 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 + +### 12.1 The same match under the v1.1 ruleset +Same cards, Topics, hands and commit lists; ruleset = §9 defaults (v1.1: `viral {base 1, cap 3}`, `encyclopedic {sides 1}`, +`rising.powerDelta -1`, `cultureKeyword "home"`). The example's Culture cards (Jazz, Pop music, Mona Lisa) are attention-home, so they stay viral. +Energy and carry are unchanged. + +What changes: +- **rising −1:** Coral reef is 1 base and ends at 1+1+2 = **4**; Fern is 3 base and ends at 3+2+1 = **6**. +- **viral base 1:** Jazz +2 (Mars earlier), Pop music +1 (base only), Mona Lisa +2 (Fern earlier). +- **nostalgic still fires** for Library (Ana is losing T1 8–13 just before it). **encyclopedic still doesn't** (Einstein is already on Ana's side of T2). + +| After turn | T1 | T2 | T3 | +|---|---|---|---| +| 1 | 3–0 | 0–3 | 0–0 | +| 2 | 4–0 | 0–3 | 3–0 | +| 3 | 7–0 | 0–9 | 3–3 | +| 4 | 8–0 | 9–9 | 3–10 | +| 5 | 8–8: **Ana leads** (consensus: on-topic 2 vs 0) | 9–10 | 13–11 | +| 6, before scoring | 18–14 | 13–18 | 13–11 | +| **final** (Main Page +1 per card in T2) | **18–14** | **15–21** | **13–11** | + +**Ana still wins 2–1.** The moments in v1.1: +- **Carry-over:** unchanged. +- **Consensus:** moves to **T1 after turn 5** (8–8). Ana has two on-topic depth cards there (Octopus, Coral reef) and Bo has only the off-topic Jupiter. +- **Interleaving:** unchanged in kind. If Ana had revealed Library before Fern, T1 would have been 8–8 at that moment, a tie is not losing, + so nostalgic would not fire and T1 would end 16–14. + +**v1.1 golden test:** expected `lanePower [[18,14],[15,21],[13,11]]`, winner p0. Also assert the T1 8–8 consensus lead for p0 after turn 5. +(Cross-checked by council-critic with the #27 engine, `tower-plus:scratchpad/critic/golden11.ts`, and by hand by designer-b.) -- 2.54.0 From 0e88b83fd99d2c8a9540400223ae8edc6ccc8ff7 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:46:40 -0500 Subject: [PATCH 09/13] =?UTF-8?q?docs/game/DESIGN.md:=20=C2=A712=20points?= =?UTF-8?q?=20to=20=C2=A712.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index ad1d746..6717cf2 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -570,7 +570,7 @@ Example modes (good defaults for operators to publish): ## 12. Worked example match *(owner: council-designer-b)* **Ruleset for this example: v1.0** (the golden test pins it): `cultureKeyword "faction"`, `viral {base 0, cap 2}`, -`encyclopedic {sides 2}`, `rising.powerDelta 0`; everything else as §9. *(v1.1 golden numbers: to be added once the engine has the v1.1 hooks.)* +`encyclopedic {sides 2}`, `rising.powerDelta 0`; everything else as §9. *(The v1.1 numbers are in §12.1.)* 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` -- 2.54.0 From 86deb073720e1e7bfe3899d946caf67fd57fed66 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 00:02:28 -0500 Subject: [PATCH 10/13] =?UTF-8?q?docs/game/DESIGN.md:=20=C2=A75.3=20clarif?= =?UTF-8?q?y=20hidden=20planning=20leaks=20no=20queue=20count=20or=20energ?= =?UTF-8?q?y=20(night-review=20viewFor=20finding)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 6717cf2..da0f9b3 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -320,6 +320,8 @@ The match lasts `turns` turns (default **6**, hard cap). Each turn has these pha - Each player queues an ordered list of plays `(handIndex, topic)`. - Total cost must be ≤ their energy, and each Topic needs room on that player's side. - Plays can be undone freely until **Commit**. Passing is an empty commit. + - **Hidden means nothing leaks.** While you plan, the opponent's hand count and energy don't change + visibly. Only the bare fact "opponent is ready" (`committed`) is shown. No queue count, no spent energy. - The turn timer is `turnSeconds` (default **25**). On timeout, whatever is queued is committed. 4. **Reveal (interleaved)** - Plays reveal **one at a time, alternating**: the initiative player's 1st, the other player's -- 2.54.0 From b29234227b87c37ea585bbd7927f44120fdc4c63 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 00:26:01 -0500 Subject: [PATCH 11/13] =?UTF-8?q?docs/game/DESIGN.md:=20v1.1=20=C2=A78=20r?= =?UTF-8?q?ows=20updated=20with=20BALANCE.md=20v1=20numbers=20(heavy=2015%?= =?UTF-8?q?,=20swarm=202%,=20top-heavy=2057%,=20seat=2051.0%,=20naive=2040?= =?UTF-8?q?%,=20owned=20vs=20starters)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index da0f9b3..5fb5f43 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -371,13 +371,14 @@ the last turn's, and every "at scoring" Portal resolves **before** Topics are ju | Line | Why it isn't dominant | |---|---| -| 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. An all-cost-5/6 deck is **weak by design**: it has four dead turns (sim-balance interim: 0–15%). There is no hard deck rule in v1; the deck builder warns when a deck has fewer than 4 cards of cost ≤ 2, and every starter deck is curve-shaped (§2.1). **sim-balance target: a **top-heavy curve** (half the deck at cost 4 or more) vs curve ≥ 40%.** `energyByTurn [2..7]` is a v1.1 candidate. | -| 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-famous (all max-stat) deck | It becomes an all-cost-5/6 deck with four dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**, and only 9 cards are seen per match (3 + 6 draws). So a pure cost-5/6 deck is **weak by design**: **BALANCE.md v1: 15%**, and no lever (power curve, energy ramp) fixes it without breaking curve or swarm decks. There is no hard deck rule; the deck builder warns below 4 cards of cost ≤ 2, and every starter is curve-shaped (§2.1). **Target met:** a **top-heavy curve** (half the deck at cost 4 or more) wins **57%** (target ≥ 40%). `energyByTurn [2..7]` was rejected for v1.1: it lifts heavy decks but kills swarm (20%). | +| All-cheap flood (cost 1–2) | Weak by design: only 9 slots and 9 cards seen. **BALANCE.md v1: 2%** (critic's sim 7–11%). Every lever that revives it breaks curve decks (sweep in BALANCE.md). viral (base +1, v1.1) is its consolation, not its fix. | | All one faction | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, splits over three keywords by home stat (§10.1), so it has no single keyword to stack. | -| "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%). | +| Owning NFTs buys power (pay-to-win) | Power depends only on cost (§1.3), and cost follows a fixed curve. **BALANCE.md v1.1:** starter decks against each other 45–55%. A realistic owned deck from `card-sample.json` against the four starters: **50 / 40 / 46 / 47%** (Field Guide / Headliners / Pioneers / Stargazers; n ≈ 55, ±13 pp). So owning cards doesn't buy power. Headliners at 40% is watched for v1.2 (lever: `local.amount 2`). | +| "Always play the highest-power card" | It ignores the on-topic bonus, lane capacity and the hidden Portals. **BALANCE.md v1:** the naive max-power line wins **40%** against greedy, and lookahead-lite beats greedy **60–70%**, so skill shows (target < 55%). Critic's sim: 18–21% against a smart bot. | | 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. | -| Seat or initiative | Planning is simultaneous and initiative strictly alternates (each seat has it for 3 of the 6 turns). Target: each seat wins 48–52%. | +| Seat or initiative | Planning is simultaneous and initiative strictly alternates (each seat has it for 3 of the 6 turns). **BALANCE.md v1.1: first player 51.0% [48.6–53.4]** (target 48–52%; v1 was 53.4%). | | Forged or shopped stats | They only raise cost (§1.3), the host check falls back to live stats (§1.10), and trend is capped at ±1. | | Inflated live pageviews | Worth at most +1, frozen at match start, and only counts for articles with ≥ 20 views a day. | | Swinginess | No effect may change a lane by more than 6 power or move cards between lanes in v1 (a keyword-design rule for §10). | -- 2.54.0 From 3c5e8f94ad869a872203c24c140bf1655eb768ec Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 00:37:17 -0500 Subject: [PATCH 12/13] =?UTF-8?q?docs/game/DESIGN.md:=20=C2=A72.1=20v1.1?= =?UTF-8?q?=20note=20uses=20BALANCE.md=20v1.1=20numbers?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index 5fb5f43..e951c6b 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -180,7 +180,8 @@ These are the default `starterDecks`: four 12-card loaner decks. 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. **v1.1 fix:** viral gets a base of +1, and Culture cards take a keyword by home stat (§10.1), so owned decks - now have all six keywords in the mix (critic sim, #1: owned vs starters 46–52%). The P31-based factions council-data proposes (People, Places, Nature, Works & Culture, + now have all six keywords in the mix. **BALANCE.md v1.1:** starters 52–53% overall, and owned vs starters 42–51% + (weakest vs Headliners and Stargazers; v1.2 candidates: `nostalgic`/`translated` `powerDelta -1`, `local.amount 2`). 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 09b55b96c36a83c1b25cb83f7fda2dd66b1e5180 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 00:37:58 -0500 Subject: [PATCH 13/13] =?UTF-8?q?docs/game/DESIGN.md:=20=C2=A78=20cite=20B?= =?UTF-8?q?ALANCE.md=20v1.1=20re-run=20(seat=2051.2%,=20starters=2052-53%,?= =?UTF-8?q?=20owned=2042-51%);=20item=206=20noted=20as=20v1.2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/game/DESIGN.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/game/DESIGN.md b/docs/game/DESIGN.md index e951c6b..00ec4cd 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -375,11 +375,11 @@ 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 four dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**, and only 9 cards are seen per match (3 + 6 draws). So a pure cost-5/6 deck is **weak by design**: **BALANCE.md v1: 15%**, and no lever (power curve, energy ramp) fixes it without breaking curve or swarm decks. There is no hard deck rule; the deck builder warns below 4 cards of cost ≤ 2, and every starter is curve-shaped (§2.1). **Target met:** a **top-heavy curve** (half the deck at cost 4 or more) wins **57%** (target ≥ 40%). `energyByTurn [2..7]` was rejected for v1.1: it lifts heavy decks but kills swarm (20%). | | All-cheap flood (cost 1–2) | Weak by design: only 9 slots and 9 cards seen. **BALANCE.md v1: 2%** (critic's sim 7–11%). Every lever that revives it breaks curve decks (sweep in BALANCE.md). viral (base +1, v1.1) is its consolation, not its fix. | | All one faction | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, splits over three keywords by home stat (§10.1), so it has no single keyword to stack. | -| Owning NFTs buys power (pay-to-win) | Power depends only on cost (§1.3), and cost follows a fixed curve. **BALANCE.md v1.1:** starter decks against each other 45–55%. A realistic owned deck from `card-sample.json` against the four starters: **50 / 40 / 46 / 47%** (Field Guide / Headliners / Pioneers / Stargazers; n ≈ 55, ±13 pp). So owning cards doesn't buy power. Headliners at 40% is watched for v1.2 (lever: `local.amount 2`). | +| Owning NFTs buys power (pay-to-win) | Power depends only on cost (§1.3), and cost follows a fixed curve. **BALANCE.md v1.1 re-run (real `RULESET_V1_1`):** each starter deck averages **52–53%** overall. A realistic owned deck from `card-sample.json` wins **42–51%** against the starters (n ≈ 55 per pairing, ±13 pp). So owning cards buys variety, not power. v1.2 levers if owned decks should be a little stronger: `local.amount 2`, and `nostalgic`/`translated` `powerDelta -1` (the two strongest keywords, about +1.65 net per card). | | "Always play the highest-power card" | It ignores the on-topic bonus, lane capacity and the hidden Portals. **BALANCE.md v1:** the naive max-power line wins **40%** against greedy, and lookahead-lite beats greedy **60–70%**, so skill shows (target < 55%). Critic's sim: 18–21% against a smart bot. | | 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. | -| Seat or initiative | Planning is simultaneous and initiative strictly alternates (each seat has it for 3 of the 6 turns). **BALANCE.md v1.1: first player 51.0% [48.6–53.4]** (target 48–52%; v1 was 53.4%). | +| Seat or initiative | Planning is simultaneous and initiative strictly alternates (each seat has it for 3 of the 6 turns). **BALANCE.md v1.1 re-run (real `RULESET_V1_1`): first player 51.2% [48.8–53.6]** (target 48–52%; v1 was 53.4%). | | Forged or shopped stats | They only raise cost (§1.3), the host check falls back to live stats (§1.10), and trend is capped at ±1. | | Inflated live pageviews | Worth at most +1, frozen at match start, and only counts for articles with ≥ 20 views a day. | | Swinginess | No effect may change a lane by more than 6 power or move cards between lanes in v1 (a keyword-design rule for §10). | -- 2.54.0