forked from WikiDeck/wikideck
Compare commits
10
Commits
v2.1
..
0e0596a855
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0e0596a855 | ||
|
|
ac46298594 | ||
|
|
a9ab940f4b | ||
|
|
175713e8b2 | ||
|
|
7390a17a91 | ||
|
|
f507b0eaed | ||
|
|
f808f963c6 | ||
|
|
01b83f9c9f | ||
|
|
1d3c5e5743 | ||
|
|
636f5b9c77 |
@@ -0,0 +1,498 @@
|
||||
# WikiDeck: Edit War — game design v1 (draft)
|
||||
|
||||
**Status:** v1 DRAFT, freeze target 23:30 EST 2026-11-16.
|
||||
**Owners:** council-designer-a owns sections 0–9 (research, card derivation, rules). council-designer-b
|
||||
owns sections 10–12 (keywords, peer-hosted modes, worked example). council-critic reviews.
|
||||
Every number in **`code font`** is a rules-config key (see §9). Modes can override any of them.
|
||||
|
||||
A two-player lane game for 3–6 minute matches. Each player has a 12-card deck and there are 3
|
||||
**Topics** (lanes) with 3 slots per side. There are 6 turns, both players plan at the same time, and
|
||||
energy ramps from 1 to 6, with 1 unspent energy carried over. Reveals interleave one card at a time.
|
||||
Win 2 of the 3 Topics. Each Topic is judged on one Wikipedia stat (**Attention**, **Depth** or
|
||||
**Reach**), and a card is stronger in a Topic that matches its best stat. Fame (how high a card's
|
||||
stats are overall) sets its **cost**, not its efficiency, so famous cards are sidegrades. They are
|
||||
not upgrades.
|
||||
|
||||
---
|
||||
|
||||
## 0. Research summary (what we took, what we left)
|
||||
|
||||
| Game | Why it's fun | Taken | Left |
|
||||
|---|---|---|---|
|
||||
| Marvel Snap | 3-minute matches; simultaneous turns; 3 lanes, so the decision is *where*, not just *what* | lanes, about 6 turns, simultaneous planning, small deck | stakes betting (modes only); we deliberately diverge in lane size (3), energy carry-over, interleaved alternating reveals, stats visible from turn 1 with hidden Portals, and on-topic tie-breaks |
|
||||
| Hearthstone | mana curve; readable cards; tempo | energy = turn number, curve-shaped costs | 30-card decks and 15-minute matches; hero powers |
|
||||
| Magic: The Gathering | factions (colours) with distinct identities; deckbuilding depth | 6 factions with their own keyword flavour | land screw (resource variance); the stack; long text |
|
||||
| Balatro | huge "moment" when a combo goes off; simple base rules plus modifiers | lane modifiers (Portals) as the run-to-run variety | single-player scoring |
|
||||
| Slay the Spire | readable intents; every card is a choice | open information about lane state and power | roguelike runs (could be a mode) |
|
||||
| Gwent | rows; best 2 of 3; passing and bluffing | best 2 of 3 Topics; hidden commitments | multi-round card advantage (too long) |
|
||||
| Pokémon TCG | type advantage | on-topic bonus (card stat matches lane stat) | energy attachment; coin flips |
|
||||
| Top Trumps | instantly understood: "my number beats yours" | lanes judged on one stat | picking the stat is solved play (always pick your best) |
|
||||
| Dominion | deck building as play | — (too long for 3–6 min) | — |
|
||||
|
||||
**What is ours, not borrowed:**
|
||||
- (a) each Topic is judged on one Wikipedia stat (the Top Trumps twist)
|
||||
- (b) cost comes from an article's fame instead of being printed
|
||||
- (c) a trend arrow driven by live pageviews
|
||||
- (d) a total-power and consensus tie-break instead of stakes betting
|
||||
- smaller choices: 3 slots per lane, 1 carried-over energy, interleaved reveals, and stats visible
|
||||
from turn 1 with hidden Portals
|
||||
|
||||
The core loop is a lanes game in the style of Snap. The Top Trumps twist is that each lane asks for
|
||||
one Wikipedia stat. That makes every stat matter and gives each turn its main decision: play the card
|
||||
on-topic for the bonus, or put it where the fight is.
|
||||
|
||||
---
|
||||
|
||||
## 1. Card derivation (card data → game card)
|
||||
|
||||
The engine never reads raw 0–100 stats as power. Every game card is derived **deterministically** from a
|
||||
`CardInput` that the match host freezes at match start:
|
||||
|
||||
```
|
||||
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)
|
||||
```
|
||||
|
||||
### 1.1 Percentiles (rank-normalisation)
|
||||
For each stat `s` in {attention, depth, reach}, `pct_s` = the percentile (0–100, integer) of the card's
|
||||
snapshot score in the reference table `percentiles.<s>`. That table holds 99 ascending cut points from
|
||||
council-data's `docs/game/card-sample.json`.
|
||||
`pct_s` = the number of cut points strictly below the score, plus half the number equal to it, rounded
|
||||
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.
|
||||
|
||||
### 1.3 Power
|
||||
`power` = `powerByCost[cost]`, default `[_, 1, 2, 4, 6, 8, 10]` (cost 1 → 1 … cost 6 → 10). The
|
||||
critic's sim showed that heavy decks were too weak with `[…5,7,9]`.
|
||||
Power depends **only on cost**. Two cards of the same cost have the same base power, whatever their
|
||||
fame. Inflating stats (forged snapshots, template shopping) only moves a card up the curve. It never
|
||||
makes a card more efficient.
|
||||
|
||||
### 1.4 Home stat
|
||||
`home` = the stat with the highest `pct_s`. Ties are broken in this order: depth, reach, attention.
|
||||
Depth and reach are the hardest to inflate. A `null` stat can never be home.
|
||||
When a card is in a Topic whose stat equals its `home`, it gets **+`onTopicBonus[cost]`** power
|
||||
(default `[0, 1, 1, 2, 2, 3, 3]`, i.e. ⌈cost/2⌉).
|
||||
On-topic efficiency is then about 2 power per energy at every cost (2.0 / 1.5 / 2.0 / 1.75 / 2.0 / 2.0).
|
||||
Off-topic, cheap cards are weaker (1.0) than expensive ones (1.5). Cheap cards want their Topic, and
|
||||
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).
|
||||
|
||||
### 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
|
||||
**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.
|
||||
|
||||
### 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.
|
||||
|
||||
### 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).
|
||||
|
||||
### 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**
|
||||
(📣 attention / 📚 depth / 🌐 reach), an optional trend arrow, and one keyword word. That is two
|
||||
numbers, plus the live lane power when the card is on the board.
|
||||
|
||||
### 1.10 Plausibility (anti-forgery, off-chain)
|
||||
When `verifyStats` is true (the default for hosted matches), the match host checks each owned card's
|
||||
snapshot before the match:
|
||||
`pageBytes` against that revision's byte size, `languageCount` ≤ the live count + 5, and views for the
|
||||
snapshot month within ±10 % of the pageviews API.
|
||||
A card that fails is played with its live values. The **host replaces `snapshot`** with a snapshot
|
||||
built from the live values (`deriveStats` on the live bytes, languages and views) **before** it builds
|
||||
the `CardInput`. The match log marks the card `unverified`.
|
||||
The engine does no I/O and only ever sees one version of each card.
|
||||
- **Caching:** results are cached per `(pageId, revisionId, snapshotMonth)`. They are immutable, so a
|
||||
cached pass or fail never expires. Live values for a failed card are cached for 24 h.
|
||||
- **Card can't be verified** (the pageId or revision doesn't exist, or the title or category doesn't
|
||||
match): the card is **rejected at deck validation**, and the player is asked to swap in a loaner.
|
||||
- **API failure:** if Wikipedia can't be reached and nothing is cached, the card plays from its snapshot
|
||||
with `check: 'unchecked'`. The engine then caps its cost at `uncheckedCostCap` (default **4**), and
|
||||
power follows the capped cost. Matches are never blocked.
|
||||
- The engine's only use of `check` is that cost cap. Loaner cards are `check: 'loaner'`.
|
||||
|
||||
---
|
||||
|
||||
## 2. Decks
|
||||
|
||||
- **Deck size:** exactly `deckSize` cards (default **12**).
|
||||
- **Copies:** at most `maxCopiesPerPage` cards with the same `pageId` (default **2**). Owned and loaner
|
||||
copies count **together**. Each copy keeps its own snapshot, so the two copies may differ in cost.
|
||||
- **Deck validation** (engine): the size is right, the copy limit holds, every card's `check` is
|
||||
valid, and there are no more loaners than `maxLoaners`. An invalid deck can't start a match.
|
||||
- **Owned cards:** any card the player's wallet owns at match start. Ownership is read off-chain. The
|
||||
match never moves, locks or burns a 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.
|
||||
- **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. A new player picks one and can play at once.
|
||||
- **Mixed decks:** an owned deck may fill any slots with loaners, up to `maxLoaners` (default 12, which
|
||||
means no limit). Owning NFTs gives **variety**, not power: owned and loaner cards follow the same
|
||||
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).
|
||||
- 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
|
||||
pool has 9 Topics: 3 per stat, one plain and two with Portals. `pool_s` is the sub-list with stat
|
||||
`s`, in file order.
|
||||
- **Topic draw (exact):**
|
||||
- If `distinctStats` is true (the default): for each stat in the fixed order
|
||||
`[attention, depth, reach]`, pick `pool_s[floor(next() × len(pool_s))]`. That uses 3 `next()`
|
||||
calls. Then Fisher–Yates the 3 picks into lanes 1–3 (i = 2, 1; j = floor(next() × (i+1))), which
|
||||
uses 2 calls.
|
||||
- If `distinctStats` is false: Fisher–Yates the whole pool (i from n−1 down to 1) and take the first
|
||||
`topicCount` entries as lanes 1–3.
|
||||
- **Stats visible, Portals hidden:** every Topic's **stat** is face-up from turn 1. Its **Portal**
|
||||
modifier is face-down until the start of turn `portalReveal[i]` (default `[2, 3, 4]`). You always
|
||||
know where your card is on-topic, but not what twist a lane will get.
|
||||
|
||||
---
|
||||
|
||||
## 4. Match setup (deterministic)
|
||||
|
||||
1. The input is `{ seed: uint32, rules, players: [p0, p1] }`, and each player's input is
|
||||
`{ id, deck: CardInput[12] }`. Seat order is input order.
|
||||
2. RNG: **mulberry32(seed)**. Every random choice draws `next()` in this fixed order:
|
||||
1. shuffle p0's deck (Fisher–Yates, i from n−1 down to 1, j = floor(next() × (i+1)))
|
||||
2. shuffle p1's deck the same way
|
||||
3. draw and shuffle the Topics
|
||||
4. the initiative coin: p0 has initiative on odd turns if next() < 0.5, otherwise p1
|
||||
5. later random events (keywords only), in resolution order
|
||||
3. Each player draws `openingHand` cards (default **3**). There are no mulligans in v1
|
||||
(`mulligan: false`).
|
||||
4. **Seed fairness (hosted PvP):** commit–reveal. Each party *i* (host, p0, p1) sends
|
||||
`sha256(r_i)` for a random 32-byte `r_i`, then reveals `r_i` once all commits are in.
|
||||
`seed` = the first 4 bytes (big-endian uint32) of `sha256(r_host ‖ r_p0 ‖ r_p1)`.
|
||||
The host still relays the hidden plans, so hosted PvP trusts the host not to leak them.
|
||||
Local and bot matches use any seed.
|
||||
|
||||
---
|
||||
|
||||
## 5. Turn structure
|
||||
|
||||
The match lasts `turns` turns (default **6**, hard cap). Each turn has these phases:
|
||||
|
||||
1. **Start**
|
||||
- Reveal any Portal scheduled for turn *t* (resolve its "on reveal").
|
||||
- Each player's energy = `energyByTurn[t-1]` + carry + `bonusEnergy`. Carry is
|
||||
min(`energyCarryMax`, unspent energy from last turn), default max **1**. Saving one energy on
|
||||
turn 2 makes a turn-3 four-drop possible: a real tempo choice.
|
||||
- Each player draws 1 card if their deck isn't empty and their hand holds fewer than `handLimit`
|
||||
(default **7**) cards. Otherwise they don't draw.
|
||||
2. **Underdog check** (mode option, `underdog: false` by default, because it can be sandbagged). When
|
||||
it's on, from turn 2, a player who leads in 0 Topics while the opponent leads in ≥ 2 gets
|
||||
**+1 energy** this turn.
|
||||
3. **Plan** (simultaneous, hidden)
|
||||
- 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.
|
||||
- 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
|
||||
1st, the initiative player's 2nd, and so on. When one player runs out, the rest of the other's
|
||||
reveal in order.
|
||||
- Each card enters its Topic and its "on reveal" effect resolves at once.
|
||||
- So the order in which you queue cards matters: lead with the card you want resolved first.
|
||||
- A queued play that is no longer legal at reveal (the lane is full or the card was removed) goes
|
||||
back to hand and its energy is lost.
|
||||
5. **End**
|
||||
- Recompute all Topic powers (§6).
|
||||
- End-of-turn effects resolve, the initiative player's first.
|
||||
- Initiative strictly **alternates** each turn (set by the coin in §4).
|
||||
- Plans are locked before anything reveals, so initiative gives away no information. It only
|
||||
decides the order of on-reveal effects. §10 includes keywords where that order matters.
|
||||
|
||||
A typical turn is: look at the lanes, tap a card, tap a Topic (×1–3), tap Commit. That is under 10
|
||||
seconds, done with one thumb, with no dragging.
|
||||
|
||||
---
|
||||
|
||||
## 6. Power and Topic control
|
||||
|
||||
- A card's **lane power** = `power` + (`onTopicBonus[cost]` if its home stat is the Topic's stat) + `trend`
|
||||
+ keyword and Portal modifiers. It is never below 0.
|
||||
- A player's **Topic power** = the sum of their cards' lane power in that Topic.
|
||||
- A player **leads** a Topic if their Topic power is strictly greater than the opponent's.
|
||||
- **Consensus tie-break:** if the powers are equal and > 0, the player with more **on-topic** cards
|
||||
there leads. If that is also equal, nobody leads. 0–0 has no leader.
|
||||
|
||||
---
|
||||
|
||||
## 7. Win conditions and tie-breaks
|
||||
|
||||
At the end of the last turn:
|
||||
1. The player who leads **more Topics** wins (2–1, 2–0, 1–0 and 3–0 all count).
|
||||
2. If they lead the same number of Topics: the higher **total power across all Topics** wins.
|
||||
3. If that is also equal: the match is a **draw**.
|
||||
|
||||
**Concede:** a player can concede at any time, and the opponent wins at once. A player who misses
|
||||
`afkTurns` timeouts in a row (default **2**) with nothing queued concedes.
|
||||
|
||||
---
|
||||
|
||||
## 8. Degenerate lines and why they fail (for the critic)
|
||||
|
||||
| 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-cheap flood (cost 1–2) | It runs out of cards (only 9 seen), and its on-topic bonus is only +1. The critic's sim had swarm vs curve at 42%. **sim-balance: test all cost-1/2 decks.** |
|
||||
| All one faction | Faction synergies are capped (`factionSynergyCap`), and Culture is the largest pool but has the weakest synergy keywords (§10). |
|
||||
| "Always play the highest-power card" | It ignores on-topic +2 (about 40% of a cheap card's power), lane capacity, and the face-down lanes. Target: < 55% against the sim's 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%. |
|
||||
| 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). |
|
||||
|
||||
---
|
||||
|
||||
## 9. Rules config (all defaults)
|
||||
|
||||
The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). Defaults:
|
||||
|
||||
```json
|
||||
{
|
||||
"version": "1.0",
|
||||
"deckSize": 12, "maxCopiesPerPage": 2, "maxLoaners": 12,
|
||||
"openingHand": 3, "handLimit": 7, "mulligan": false,
|
||||
"turns": 6, "turnSeconds": 25, "afkTurns": 2,
|
||||
"energyByTurn": [1, 2, 3, 4, 5, 6], "energyCarryMax": 1, "bonusEnergy": 0, "underdog": false,
|
||||
"topicCount": 3, "distinctStats": true, "portalReveal": [2, 3, 4], "laneCapacity": 3,
|
||||
"topicPool": "default",
|
||||
"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,
|
||||
"trendUp": 25, "trendDown": -25, "trendMinDaily": 20, "uncheckedCostCap": 4,
|
||||
"factionSynergyCap": 3,
|
||||
"verifyStats": true,
|
||||
"percentiles": "card-sample-2026-11-16",
|
||||
"starterDecks": "default"
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
**What modes may vary:** every key above, plus `topicPool` contents and the starter-deck lists.
|
||||
**Fixed for all modes:** matches are off-chain and never move or burn NFTs; the RNG and its draw order
|
||||
(§4); the shape of the derivation (§1: percentile → fame → cost → power); at most one keyword per card;
|
||||
the phases of a turn (§5).
|
||||
A mode must keep `turns × turnSeconds ≤ 240` so that matches stay within 3–6 minutes.
|
||||
|
||||
---
|
||||
|
||||
## 10. Keywords *(owner: council-designer-b)*
|
||||
|
||||
### 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:
|
||||
|
||||
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).
|
||||
|
||||
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.
|
||||
|
||||
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).
|
||||
|
||||
### 10.2 Keyword list
|
||||
|
||||
| Keyword | Source | Trigger | Reminder text | Cap |
|
||||
|---|---|---|---|---|
|
||||
| **Buzz** | home: attention | On reveal | +1 power to each of your *other* cards here. | +3 (lane cap 4) |
|
||||
| **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 | +2 power on the last turn. | +2 |
|
||||
| **Remix** | faction: Culture | On reveal | +2 power if you are losing here. | +2 |
|
||||
|
||||
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.
|
||||
- **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.
|
||||
|
||||
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.
|
||||
|
||||
### 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
|
||||
Portals for each stat. A Portal applies from the moment its Topic is revealed (§3), except where it says otherwise.
|
||||
|
||||
| Topic | Stat | Portal rule |
|
||||
|---|---|---|
|
||||
| Current Events | attention | – |
|
||||
| Main Page | attention | On the last turn, each card here gets +1 power. |
|
||||
| Trending | attention | Trend arrows (§1.6) count double here (±2). |
|
||||
| Archive | depth | – |
|
||||
| Featured Article | depth | At end of the match, the player with the single highest-power card here gets +2 Topic power here (no bonus if tied). |
|
||||
| Stub | depth | Lane capacity here is 2 per player. |
|
||||
| Translations | reach | – |
|
||||
| Interwiki | reach | +1 Topic power here for a player who has at least one card in all 3 Topics. |
|
||||
| Disambiguation | reach | Every card here counts as on-topic, whatever its home stat. |
|
||||
|
||||
As data: `portal = { kind: "lastTurnCardBonus", amount: 1 } | { kind: "trendMultiplier", factor: 2 } |
|
||||
{ kind: "highestCardBonus", amount: 2 } | { kind: "laneCapacity", value: 2 } | { kind: "spreadBonus", amount: 1 } |
|
||||
{ kind: "allOnTopic" }`. Modes may add Topics with these kinds, using new numbers, but not new kinds (engine code).
|
||||
|
||||
---
|
||||
|
||||
## 11. Peer-hosted modes *(owner: council-designer-b)*
|
||||
|
||||
A **mode** is data, published by a node operator and run by the match host:
|
||||
```json
|
||||
{
|
||||
"id": "blitz", // [a-z0-9-]{3,32}, unique per host
|
||||
"name": "Blitz", "description": "Four quick turns.", // ≤ 40 and ≤ 280 chars, plain text
|
||||
"rules": { "turns": 4, "energyByTurn": [2, 3, 4, 5], "portalReveal": [1, 1, 2], "deckSize": 10 },
|
||||
"topicPool": [ /* optional: Topic objects (10.3); default if omitted */ ],
|
||||
"starterDecks": [ /* optional: lists of loaner pageIds */ ]
|
||||
}
|
||||
```
|
||||
- `rules` is a **partial** `RulesConfig` (§9) merged over the defaults. Unknown keys are rejected.
|
||||
- **Validation** (modes owns the code; these are the limits). If any check fails, the mode is refused:
|
||||
|
||||
| Key | Allowed |
|
||||
|---|---|
|
||||
| `turns` | 3–8, and `turns × turnSeconds ≤ 240` |
|
||||
| `energyByTurn` | length = `turns`, each 0–10 |
|
||||
| `bonusEnergy` | 0–3 |
|
||||
| `portalReveal` | length = `topicCount`, each 1..`turns`, non-decreasing |
|
||||
| `topicCount` | 1–5; `distinctStats` only if ≤ 3 |
|
||||
| `laneCapacity` | 1–6 |
|
||||
| `deckSize` | 6–20; `maxCopiesPerPage` 1–4; `maxLoaners` 0..`deckSize` |
|
||||
| `openingHand` | 0–6; `handLimit` 1–10 |
|
||||
| `turnSeconds` | 10–60; `afkTurns` 1–5 |
|
||||
| `costThresholds` | 5 strictly ascending integers in 0–100 |
|
||||
| `powerByCost` | 7 integers in 0–20, non-decreasing from index 1 |
|
||||
| `onTopicBonus` (7 entries), `vanillaBonus` | 0–5 each |
|
||||
| `trendUp` / `trendDown` | 0–200 / −200–0 |
|
||||
| `factionSynergyCap` | 0–6 |
|
||||
| `keywordsEnabled` (new, default: all 9) | any subset of the 9 v1 keywords; a disabled keyword makes those cards vanilla, *without* `vanillaBonus` |
|
||||
| `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 |
|
||||
|
||||
- **Identity:** `modeHash` = SHA-256 of the canonical JSON (sorted keys, no whitespace) of the *merged* rules
|
||||
plus the topicPool. A match record holds `{ modeHash, seed, both decks' CardInputs, both players' commit lists }`,
|
||||
and that is enough to replay it exactly.
|
||||
- **What modes can't change** is the "Fixed for all modes" list in §9. Modes also can't add keywords or Portal kinds, or
|
||||
stake, move or burn NFTs.
|
||||
|
||||
Example modes (good defaults for operators to publish):
|
||||
| Mode | Overrides | Feel |
|
||||
|---|---|---|
|
||||
| **Blitz** | `turns 4`, `energyByTurn [2,3,4,5]`, `portalReveal [1,1,2]`, `deckSize 10`, `turnSeconds 20` | about 2 minutes |
|
||||
| **Deep Cuts** | `topicPool`: only the 3 depth Topics, `distinctStats false` | rewards long, obscure articles |
|
||||
| **Loaner League** | `maxLoaners 12` and owned cards banned (`"ownedCards": false`, a new boolean key, default true) | fully level, for tournaments |
|
||||
| **Big Board** | `topicCount 5`, `distinctStats false`, `portalReveal [1,2,3,4,5]`, `laneCapacity 3` | win 3 of 5 |
|
||||
| **No Keywords** | `keywordsEnabled []`, `onTopicBonus 3` | Top Trumps–style tutorial mode |
|
||||
|
||||
---
|
||||
|
||||
## 12. Worked example match *(owner: council-designer-b)*
|
||||
|
||||
> **⚠ Out of date (merge note from designer-a):** this example was written against the #12 draft:
|
||||
> flat +2 on-topic, `powerByCost [..5,7,9]`, laneCapacity 4, and Topics revealed one per turn.
|
||||
> §1–9 now use `onTopicBonus [0,1,1,2,2,3,3]`, `powerByCost [0,1,2,4,6,8,10]`, laneCapacity 3,
|
||||
> 1 carried-over energy, interleaved reveals, alternating initiative, stats visible from turn 1, and
|
||||
> Portals revealed on turns 2–4. designer-b is recomputing it. **engine-b: don't use the golden
|
||||
> numbers below until this note is gone.**
|
||||
|
||||
Default rules. The derived cards are given directly (§1 output). "base" = `powerByCost[cost]`, with +1 for cost-1 vanilla cards.
|
||||
Topics after the seeded draw: **T1 Archive (depth)**, **T2 Main Page (attention)**, **T3 Translations (reach)**.
|
||||
Ana (p0) has initiative on turn 1. Neither player has a trend arrow.
|
||||
|
||||
Cards played:
|
||||
| Player | Card | Faction / rarity | Cost | Base | Home | Keyword |
|
||||
|---|---|---|---|---|---|---|
|
||||
| Ana | Octopus | Nature / Common | 1 | 2 | depth | – (vanilla) |
|
||||
| Ana | Moon | Space / Common | 2 | 2 | reach | Echo |
|
||||
| Ana | Periodic table | Science / Rare | 3 | 4 | depth | Research |
|
||||
| Ana | Albert Einstein | People / Epic | 4 | 5 | attention | Rally |
|
||||
| Ana | Ancient Rome | History / Rare | 5 | 7 | depth | Legacy |
|
||||
| Ana | Library of Alexandria | History / Common | 4 | 5 | depth | Anchor |
|
||||
| Ana | Coral reef | Nature / Common | 2 | 2 | depth | Anchor |
|
||||
| Bo | Haiku | Culture / Common | 1 | 2 | attention | – (vanilla) |
|
||||
| Bo | Jazz | Culture / Rare | 2 | 2 | attention | Remix |
|
||||
| Bo | Fern | Nature / Rare | 3 | 4 | depth | Grow |
|
||||
| Bo | Pop music | Culture / Common | 4 | 5 | attention | Buzz |
|
||||
| Bo | Jupiter | Space / Epic | 5 | 7 | reach | Orbit |
|
||||
| Bo | Saturn | Space / Legendary | 6 | 9 | reach | Orbit |
|
||||
|
||||
Topic power is written as **Ana–Bo**. "Lead" is the number of Topics each player leads after the turn.
|
||||
|
||||
| Turn | Revealed | Ana plays (reveals first when she has initiative) | Bo plays | T1 | T2 | T3 | Lead | Initiative next |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| 1 | T1 Archive | Octopus → T1: 2, +2 on-topic = **4** | Haiku → T1: **2** (attention ≠ depth) | 4–2 | 0–0 | 0–0 | 1–0 | Ana (leads more) |
|
||||
| 2 | T2 Main Page | Moon → T3 (face-down, no bonus yet): 2. Echo: Octopus +1 → 5 | Jazz → T2: 2+2 = 4. Remix: Ana has 0 here, so not losing, no bonus | 5–2 | 0–4 | 2–0 | 2–1 | Ana |
|
||||
| 3 | T3 Translations: Moon is now on-topic, 4 | Periodic table → T1: 4+2 = 6. Research: Ana leads T1 (11–2) and T3 (4–0) → +2 = **8** | Fern → T1: 4+2 = 6. End of turn, Grow: 7 | 13–9 | 0–4 | 4–0 | 2–1 | Ana |
|
||||
| 4 | – | Einstein → T2: 5+2 = 7. Rally: no other People cards, so nothing | Pop music → T2: 5+2 = 7. Buzz: Jazz +1 → 5. Grow: Fern 8 | 13–10 | 7–12 | 4–0 | 2–1 | Ana |
|
||||
| 5 | – | Ancient Rome → T3: 7 (depth ≠ reach) | Jupiter → T3: 7+2 = 9. Orbit: Bo's T2 +1 → 13. Grow: Fern 9 (the +3 cap is reached) | 13–11 | 7–13 | 11–9 | 2–1 | Ana |
|
||||
| 6 (last) | Main Page: +1 per card. Legacy: Rome 9 | Library of Alexandria → T3: 5. Anchor: not the only card, so no bonus. Coral reef → T1: 2+2 = 4 (Anchor: no) | Saturn → T3: 9+2 = 11. Orbit: Bo's T2 +1 | **17–11** | **8–16** | **18–20** | 1–2 | – |
|
||||
|
||||
The turn-6 numbers:
|
||||
- **T1:** Ana has Octopus 5 + Periodic table 8 + Coral reef 4 = 17. Bo has Haiku 2 + Fern 9 = 11.
|
||||
- **T2:** Ana has Einstein 7 + 1 (Main Page) = 8. Bo has Jazz 5+1 and Pop music 7+1, plus Orbit ×2, = 16.
|
||||
- **T3:** Ana has Moon 4 + Rome 9 + Library 5 = 18. Bo has Jupiter 9 + Saturn 11 = 20.
|
||||
|
||||
**Bo wins 2–1.** Bo trailed 1–2 from turn 2 to turn 5. Ana guessed Bo would contest T3 and spent 4 of her 6 energy there. Saturn on-topic (11) still beat her by 2, and its Orbit also tipped T2. The underdog check never fired, because Bo always led one Topic.
|
||||
Energy check: Ana spent 1/2/3/4/5/6 and Bo spent 1/2/3/4/5/6.
|
||||
|
||||
**Golden test for engine-b:** with these card inputs, this Topic order and these commit lists, the final Topic powers must be
|
||||
`T1 17–11, T2 8–16, T3 18–20`, and the result must be a Bo win (2 Topics to 1). Only the seed's Topic draw and the decks' order
|
||||
vary. The test should inject the Topic order and the hands directly.
|
||||
@@ -0,0 +1,53 @@
|
||||
# Night 1: module boundaries
|
||||
|
||||
Owner: `night-lead`. This file is the rule when two PRs touch the same path. If you need to edit a path you don't own, comment on the owner's issue (`[from <you>]`) or keep your change to the "shared hook" listed below.
|
||||
|
||||
## Who owns what
|
||||
|
||||
| Path | Owner | Issue |
|
||||
|---|---|---|
|
||||
| `docs/game/DESIGN.md` | council (designer-a, designer-b, critic) | #1 |
|
||||
| `docs/game/CARD_DATA.md`, `docs/game/card-sample.json` | council-data | #2 |
|
||||
| `shared/game/` (types, RNG, state machine, rules, keywords, `Ruleset`, `starterDeck`) | engine-a (core, API), engine-b (keywords, effects) | #3 |
|
||||
| `docs/game/ENGINE_API.md` | engine-a | #3 |
|
||||
| `shared/game/modes.ts` | modes | #6 |
|
||||
| `server/game*` (e.g. `server/game/`, `server/game-*.ts`) | modes | #6 |
|
||||
| `docs/game/HOSTING.md` | modes | #6 |
|
||||
| `src/game/` (screens, lobby, deck builder, match, tutorial) | ui-a | #5 |
|
||||
| `src/game/ai/` (browser bots, easy and normal) | ui-b | #5 |
|
||||
| beta-fix files outside `src/game/` (landing page, `Card.tsx`, etc.) | ui-b, one PR per upstream issue | #5 |
|
||||
| `shared/bots/`, `scripts/sim/` (bots and the simulation runner) | sim-balance | #4 |
|
||||
| `docs/game/BALANCE.md` | sim-balance | #4 |
|
||||
| `compose.testnet.yaml` overrides, `deploy/night/` (testnet config, per-node mode files) | sim-testnet | #4 |
|
||||
| `server/account*` (e.g. `server/account/`), `src/auth/` | sso | #7 |
|
||||
| `android/`, `capacitor.config.ts` | mobile-android | #8 |
|
||||
| `ios/`, `docs/night/IOS.md` | mobile-ios, macos-fetch | #9 |
|
||||
| `docs/night/` (except `IOS.md`), this file, `REPORT.md` | night-lead | #10 |
|
||||
|
||||
## Tests
|
||||
|
||||
`scripts/run-tests.mjs` only picks up **top-level** `tests/*.test.ts`. Name your files with your team as a prefix so they never collide:
|
||||
`tests/game-*.test.ts` (engine), `tests/modes-*.test.ts`, `tests/ui-*.test.ts`, `tests/bots-*.test.ts`, `tests/account-*.test.ts`.
|
||||
|
||||
## Shared hooks (the only places two teams touch the same file)
|
||||
|
||||
1. **`server/testnet/http.ts`**: modes and sso each export an Express `Router` from their own files and add **exactly one** `app.use(...)` mount line just **above** the `/api` 404 handler (`app.use(['/api','/p2p'],(_req,res)=>{res.status(404)...`). Nothing else in this file. If SSO needs a CSP change (`connect-src` for `https://dex.eom.dev`), keep it to the `helmet` directive and say so in the PR.
|
||||
2. **`src/App.tsx`**: ui-a owns it. Others get one import and one element each (sso: a login button or provider; mobile: hide the mining controls behind a `isNativeApp()` check from `src/game/` or `src/auth/`, never by deleting code).
|
||||
3. **`package.json` and `package-lock.json`**: additive changes only (new dependencies or scripts). Don't reformat or bump existing versions. Lockfile conflicts are resolved by night-lead regenerating the lockfile.
|
||||
4. **`shared/enrichment.ts`**: read-only for everyone tonight. Map card data into game stats inside `shared/game/`.
|
||||
|
||||
## Off limits (consensus and protocol; PRs touching these are rejected)
|
||||
|
||||
`server/chain.ts`, `shared/protocol.ts`, `shared/trade-offer.ts`, `shared/chain-identity.ts`, `shared/network.ts`, `server/testnet/consensus.ts`, `server/testnet/ledger.ts`, `server/testnet/canonical-index.ts`, `server/testnet/randomx.ts`, `server/testnet/miner.ts`, `server/testnet/peers.ts`, `native/`.
|
||||
|
||||
If you think you need a change there, write it up in your issue instead.
|
||||
|
||||
## Dependency direction
|
||||
|
||||
`shared/game/` imports nothing from `server/` or `src/` and does no I/O. `shared/game/modes.ts`, `shared/bots/`, `server/game*`, `src/game/` import from `shared/game/` through the API in `ENGINE_API.md`, not from its internals.
|
||||
|
||||
## Merging
|
||||
|
||||
- Branch `night/<team>/<topic>`, PR into `night/2026-11-16`, squash-merged by night-lead after night-review approves and `npm test` and `npm run build` pass.
|
||||
- Small PRs merge faster. Rebase on the integration branch before asking for review if it moved under you.
|
||||
- After 01:10 (code freeze), only fixes merge.
|
||||
@@ -0,0 +1,98 @@
|
||||
# WikiDeck Night 1: team handbook
|
||||
|
||||
Read this whole file before doing anything. It's the contract between about 17 agents on 4 machines.
|
||||
|
||||
**Coordinator:** the Claude session on tower-plus (Eric's interactive session).
|
||||
**Lead/integrator:** `night-lead` on tower-plus.
|
||||
**Window:** 2026-11-16 22:45 until **01:30 EST, hard stop**.
|
||||
**Milestone:** https://gitea.eom.dev/claude/wikideck/milestone/63
|
||||
|
||||
## Goal
|
||||
Turn WikiDeck into a game:
|
||||
1. A **fun, robust, balance-tested card game**, playable in the browser against a private testnet.
|
||||
2. **eom.dev accounts:** log in through Dex SSO, and link a self-custodial wallet to your account.
|
||||
3. **Peer-hosted game modes:** node operators publish their own modes as an incentive to run a peer.
|
||||
4. **An Android app**, built and running in an emulator, and an **iOS app** (macOS VM; Xcode sign-in waits for Eric).
|
||||
|
||||
## Hard rules (no exceptions)
|
||||
- **Where to push:** only to `git@gitea.eom.dev:claude/wikideck.git`. Never push to `WikiDeck/wikideck` (upstream) or to `main` on this fork.
|
||||
- **Branches:** every change goes on a branch named `night/<team>/<topic>`, through a PR into **`night/2026-11-16`**. Only `night-lead` merges.
|
||||
- **Live services:** don't touch the live wikideck deployment (k8s namespace `wikideck`) or mainnet. The testnet is private, on poweredge-r350.
|
||||
- **No consensus or protocol changes:**
|
||||
- no block, transfer or trade format changes
|
||||
- nothing that changes validation in `server/chain.ts` or `shared/protocol.ts`
|
||||
- the game runs **off-chain**
|
||||
- if you think you need a protocol change, write it up in your issue instead
|
||||
- **Production SSO:** don't change Dex or any other production service yourself. The SSO team prepares the Dex change, and the coordinator reviews and applies it.
|
||||
- **Nothing public:** only `night-lead` and the scheduled standup post on Discourse (planning topic only). No other public posts, no purchases or sign-ups, and no secrets in git.
|
||||
- **The printer and CNC:** inspiron-3670 drives a 3D printer and a CNC router. Never start, resume or send a print or cut.
|
||||
- **Git identity** in every clone:
|
||||
```
|
||||
git config user.name Claude
|
||||
git config user.email claude@eom.dev
|
||||
git config commit.gpgsign false
|
||||
```
|
||||
End commit messages with `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
|
||||
- **Before opening a PR:** `npm test` and `npm run build` must pass. If something can't pass yet, say so in the PR.
|
||||
|
||||
## How we coordinate
|
||||
**Gitea is the shared brain.** The machines don't share a filesystem, and workers can't message each other.
|
||||
- **Your issue is your inbox.**
|
||||
- Prefix every comment with your agent name, e.g. `[engine-a]`.
|
||||
- Check your issue and your PRs for new comments **at least every 15 minutes** and whenever you finish a step.
|
||||
- **Status labels on your issue:**
|
||||
- `status/in-progress` while you're working
|
||||
- `status/needs-review` when a PR is up
|
||||
- `status/blocked` with a comment explaining why
|
||||
- `status/done` when finished
|
||||
- **Need another team?** Comment on *their* issue, starting with `[from <you>]`.
|
||||
- **Contracts beat conversations.** Interfaces live in files on the integration branch (`docs/game/*.md`, TypeScript types). Read them before asking.
|
||||
- **When the lead (or the coordinator) messages you directly** through herdr, the message is a peer request within this plan. Act on it.
|
||||
- **Stuck for more than 10 minutes?** Label `status/blocked` and comment. Don't spin.
|
||||
|
||||
## Resources (be a good neighbour)
|
||||
- **inspiron-3670** (6 cores, 60 GB RAM) has 7 agents, the Android emulator and a macOS VM. Wrap heavy commands in a shared lock:
|
||||
```
|
||||
flock /tmp/night-heavy.lock <npm ci | npm run build | gradle ...>
|
||||
```
|
||||
- **imac** (8 threads, about 4 GB free) and **poweredge-r350** (16 threads, about 6 GB free): keep builds to one at a time.
|
||||
- **LocalAI** (`https://localai.eom.dev`) is shared production with slow single-GPU inference. Don't use it in loops.
|
||||
|
||||
## Timeline (EST)
|
||||
|
||||
| Time | Milestone |
|
||||
|---|---|
|
||||
| 22:45 | Kickoff. The design council researches. Infra teams set up (testnet, Android SDK, macOS, SSO scaffolding, UI shell, beta fixes). |
|
||||
| **23:30** | **Design v1 frozen** (`docs/game/DESIGN.md`). The engine team implements it. |
|
||||
| 23:45 | **Engine API contract** (`docs/game/ENGINE_API.md` plus TypeScript types) on the integration branch, so UI, simulation and modes can build against it. |
|
||||
| 00:15 | Engine alpha. Simulation starts bot matches. The UI wires up real matches. |
|
||||
| 00:45 | Balance report v1. The council tunes the rules (v1.1). |
|
||||
| **01:10** | **Code freeze:** fixes only. The lead integrates. QA plays end to end. |
|
||||
| 01:25 | Final reports in each issue. The lead writes `docs/night/REPORT.md`. |
|
||||
| **01:30** | **Stop.** |
|
||||
|
||||
## Teams
|
||||
|
||||
| Agent | Machine | Issue |
|
||||
|---|---|---|
|
||||
| council-designer-a, council-designer-b, council-data | imac | Game design council, card data analysis |
|
||||
| council-critic, night-lead, night-review, macos-fetch | tower-plus | Design council (critic), integration and QA, iOS (download) |
|
||||
| engine-a, engine-b | inspiron-3670 | Game engine |
|
||||
| ui-a, ui-b | inspiron-3670 | Game UI and AI opponent, beta fixes |
|
||||
| modes | inspiron-3670 | Peer-hosted game modes |
|
||||
| mobile-android, mobile-ios | inspiron-3670 | Android app, iOS app and macOS VM |
|
||||
| sim-testnet, sim-balance, sso | poweredge-r350 | Testnet and simulation, eom.dev accounts |
|
||||
|
||||
## What the cards hold (game design input)
|
||||
Each card's data comes from `shared/enrichment.ts`: `PageEnrichment` and `MintStatsSnapshot`.
|
||||
- **Identity:** `title`, `description`, `wikidataId` (structured facts: instance-of, dates, coordinates...) and `categories[]`
|
||||
- **Size and history:** `pageBytes` and `revisionId`
|
||||
- **Reach:** `languageCount`, the number of language editions
|
||||
- **Pageviews:** monthly views, `total`, `dailyAverage` and `trendPercent`
|
||||
- **Derived 0–100-ish scores:** `stats.attention`, `stats.depth` and `stats.reach`
|
||||
- **Two values for everything:** an immutable **at-mint snapshot** and **live current values** that change over time
|
||||
- **Duplicates:** the same article can be minted more than once, each copy with its own snapshot
|
||||
|
||||
Two facts to design around:
|
||||
- **New players own no cards.** The design must give them a way to play immediately, for example starter decks of preview or loaner cards that don't touch NFTs.
|
||||
- **Cards are NFTs.** A match must never move or burn cards on-chain tonight.
|
||||
Reference in New Issue
Block a user