From 6ba2bc3a5607582560d6700b15ba7c25d7c11a72 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:03:45 -0500 Subject: [PATCH 1/5] 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 6172319efbd978d8eab9f3a536e0e1e3ef070733 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:07:27 -0500 Subject: [PATCH 2/5] 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 05ff734df298af1470f533fc9a1b9e1de6c21bc0 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:10:03 -0500 Subject: [PATCH 3/5] 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 5205201143f5700a31ac3c656a0e60fc888f46bf Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:07:32 -0500 Subject: [PATCH 4/5] =?UTF-8?q?docs(game):=20=C2=A78=20retarget=20heavy=20?= =?UTF-8?q?to=20top-heavy=20curve;=20deck-builder=20warning,=20no=20hard?= =?UTF-8?q?=20rule?= 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 3340094..0b75e6f 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -357,7 +357,7 @@ 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. 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-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 (1/1/2/2/3/3 cards at costs 1–6, as in sim-balance's interim run) 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). | | "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%). | -- 2.54.0 From aef9462ef1ffda75a8030110adff6be27c8cbdd8 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 23:08:21 -0500 Subject: [PATCH 5/5] =?UTF-8?q?docs(game):=20critic's=20freeze=20edits:=20?= =?UTF-8?q?=C2=A78=20top-heavy=20wording;=20trendDown=20-200=20(no=20down?= =?UTF-8?q?=20arrow=20in=20v1)?= 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 0b75e6f..262efcd 100644 --- a/docs/game/DESIGN.md +++ b/docs/game/DESIGN.md @@ -92,8 +92,9 @@ 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), -otherwise 0. A `null` value gives 0. Trend also needs `live.dailyAverage ≥ trendMinDaily` (default +`trend` = +1 if `live.trendPercent ≥ trendUp` (default 25), −1 if `≤ trendDown` (default **−200**, +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. @@ -357,7 +358,7 @@ 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 (1/1/2/2/3/3 cards at costs 1–6, as in sim-balance's interim run) vs curve ≥ 40%.** `energyByTurn [2..7]` is a v1.1 candidate. | +| 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). | | "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%). | @@ -389,7 +390,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