forked from WikiDeck/wikideck
Overnight build by 17 Claude agents (2026-11-16 22:45 → 01:30 EST), coordinated in [claude/wikideck milestone 63](https://gitea.eom.dev/claude/wikideck/milestone/63). **For Eric's review. Do not merge without it.** The full write-up is in `docs/night/REPORT.md`. **What's in it** (38 reviewed PRs, squash-merged into `night/2026-11-16`): - **Edit War:** - a 3-lane, 6-turn card game built on what WikiDeck cards actually hold - a pure, deterministic, off-chain rules engine (`shared/game/`, with the API in `docs/game/ENGINE_API.md`); rules are data and v1.1 is the default - a mobile-first Play UI with a lobby, deck builder, four loaner starter decks, a match against the AI, results and a tutorial - a landing page (fixes #3) - **Design and balance:** `docs/game/DESIGN.md`, `CARD_DATA.md` (236 sampled articles) and `BALANCE.md` (bot simulations). Starter pairings went from 23–77% on v1 to roughly even on v1.1. - **eom.dev accounts:** Dex OIDC with PKCE, plus off-chain wallet linking, where the client builds the message it signs (`server/account/`, `src/auth/`). - **Peer-hosted game modes:** modes are JSON data, never code. Node API at `/api/game/*`, with host credit and leaderboards. Three example modes (`shared/game/modes.ts`, `server/game/`, `docs/game/HOSTING.md`). - **Mobile:** Capacitor 7 Android app (a debug APK played a full match against the AI in the emulator), and an iOS project waiting on Xcode (`docs/night/ANDROID.md`, `docs/night/IOS.md`). - **Testnet tooling:** `deploy/night/` (LAN-only, 3 nodes) and an optional `WIKIDECK_USER_AGENT` (the default is unchanged). **Not touched:** consensus and protocol (`server/chain.ts`, `shared/protocol.ts`, `server/testnet/{consensus,ledger,…}.ts`, `native/`), the live deployment and mainnet. Matches run off-chain and never move or burn NFTs. **Checks:** the final integration gate passed in `node:24-alpine`: `npm test` 241/242 with 0 fail (1 skipped), and `npm run build` passes. The repo needs Node 24, because Node 20 fails 12 tests falsely. **Decisions for Eric** (see REPORT.md, Known issues and Next steps): 1. whether the live node should set `WIKIDECK_USER_AGENT` 2. the Xcode licence, which you should accept yourself 3. #49 in the fork, a bot change held after the freeze 4. on-chain host rewards (proposal only, in HOSTING.md) 🤖 Generated with [Claude Code](https://claude.com/claude-code)Reviewed-on: WikiDeck/wikideck#22 Co-authored-by: Claude <claude@eom.dev>
149 lines
7.3 KiB
TypeScript
149 lines
7.3 KiB
TypeScript
/**
|
||
* Ruleset (DESIGN §9 RulesConfig): every rule number as data, so peer-hosted
|
||
* modes can vary them without running code. parseRuleset() is the only way
|
||
* untrusted JSON should become a Ruleset; its bounds keep matches short and
|
||
* guarantee termination.
|
||
*/
|
||
import { z } from 'zod';
|
||
import { KEYWORD_IDS, PORTAL_IDS } from './keywords.ts';
|
||
import { STATS, type Ruleset } from './types.ts';
|
||
|
||
const int = (min: number, max: number) => z.number().int().min(min).max(max);
|
||
const id = z.string().regex(/^[a-z0-9][a-z0-9-]{0,31}$/);
|
||
const params = z.record(z.string().regex(/^[A-Za-z0-9]{1,24}$/), z.number().finite().min(-100).max(100))
|
||
.refine(value => Object.keys(value).length <= 8, 'At most 8 params');
|
||
const paramTable = z.record(id, params).refine(value => Object.keys(value).length <= 32, 'At most 32 entries');
|
||
|
||
export const TopicSchema = z.object({
|
||
id, name: z.string().min(1).max(32), stat: z.enum(STATS as [string, ...string[]]), portal: z.enum(PORTAL_IDS).nullable(),
|
||
}).strict();
|
||
|
||
export const RulesetSchema = z.object({
|
||
version: z.string().min(1).max(16),
|
||
deckSize: int(1, 30),
|
||
maxCopiesPerPage: int(1, 30),
|
||
maxLoaners: int(0, 30),
|
||
openingHand: int(0, 10),
|
||
handLimit: int(1, 12),
|
||
mulligan: z.literal(false), // not implemented in v1
|
||
turns: int(1, 12),
|
||
turnSeconds: int(5, 120),
|
||
afkTurns: int(1, 12),
|
||
energyByTurn: z.array(int(0, 20)).min(1).max(12),
|
||
energyCarryMax: int(0, 10),
|
||
bonusEnergy: int(0, 10),
|
||
underdog: z.boolean(),
|
||
topicCount: int(1, 5),
|
||
distinctStats: z.boolean(),
|
||
portalReveal: z.array(int(1, 12)).max(5),
|
||
laneCapacity: int(1, 8),
|
||
topicPool: z.array(TopicSchema).min(1).max(32),
|
||
keywordParams: paramTable,
|
||
portalParams: paramTable,
|
||
costThresholds: z.array(int(0, 100)).length(5),
|
||
powerByCost: z.array(int(0, 30)).length(7),
|
||
onTopicBonus: z.array(int(0, 10)).length(7),
|
||
vanillaBonus: int(0, 10),
|
||
keywordsEnabled: z.array(z.enum(KEYWORD_IDS)).max(KEYWORD_IDS.length),
|
||
ownedCards: z.boolean(),
|
||
cultureKeyword: z.enum(['faction', 'home']).default('faction'), // default keeps pre-v1.1 stored rulesets parseable
|
||
trendUp: z.number().finite().min(-1000).max(1000),
|
||
trendDown: z.number().finite().min(-1000).max(1000),
|
||
trendMinDaily: z.number().finite().min(0).max(1e9),
|
||
uncheckedCostCap: int(1, 6),
|
||
factionSynergyCap: int(0, 12),
|
||
verifyStats: z.boolean(),
|
||
percentiles: id,
|
||
starterDecks: id,
|
||
}).strict().superRefine((rules, ctx) => {
|
||
const issue = (message: string) => ctx.addIssue({ code: 'custom', message });
|
||
if (rules.turns * rules.turnSeconds > 240) issue('turns × turnSeconds must be ≤ 240');
|
||
if (rules.energyByTurn.length < rules.turns) issue('energyByTurn needs one entry per turn');
|
||
if (rules.portalReveal.length !== rules.topicCount) issue('portalReveal needs one entry per Topic');
|
||
if (rules.openingHand > rules.handLimit) issue('openingHand > handLimit');
|
||
if (rules.trendDown > rules.trendUp) issue('trendDown > trendUp');
|
||
if (rules.costThresholds.some((value, i) => i > 0 && value < rules.costThresholds[i - 1])) issue('costThresholds must ascend');
|
||
if (rules.distinctStats) {
|
||
if (rules.topicCount !== STATS.length) issue('distinctStats needs topicCount == 3');
|
||
const stats = new Set(rules.topicPool.map(topic => topic.stat));
|
||
if (stats.size < rules.topicCount) issue('topicPool lacks enough distinct stats');
|
||
} else if (rules.topicPool.length < rules.topicCount) issue('topicPool smaller than topicCount');
|
||
const topicIds = new Set<string>();
|
||
for (const topic of rules.topicPool) {
|
||
if (topicIds.has(topic.id)) issue(`Duplicate topic id: ${topic.id}`);
|
||
topicIds.add(topic.id);
|
||
}
|
||
if (new Set(rules.keywordsEnabled).size !== rules.keywordsEnabled.length) issue('Duplicate keywordsEnabled entry');
|
||
for (const key of Object.keys(rules.keywordParams)) if (!(KEYWORD_IDS as readonly string[]).includes(key)) issue(`Unknown keyword: ${key}`);
|
||
for (const key of Object.keys(rules.portalParams))
|
||
if (!topicIds.has(key) && !(PORTAL_IDS as readonly string[]).includes(key)) issue(`portalParams key is neither a Topic id nor a Portal id: ${key}`);
|
||
});
|
||
|
||
/** Validate untrusted ruleset JSON. Throws a ZodError with readable issues. */
|
||
export function parseRuleset(input: unknown): Ruleset {
|
||
return RulesetSchema.parse(input) as Ruleset;
|
||
}
|
||
|
||
/** DESIGN §10.3 default Topic pool: per stat one plain Topic and two with Portals. Portal kind = Topic id. */
|
||
export const DEFAULT_TOPIC_POOL: Ruleset['topicPool'] = [
|
||
{ id: 'current-events', name: 'Current Events', stat: 'attention', portal: null },
|
||
{ id: 'main-page', name: 'Main Page', stat: 'attention', portal: 'main-page' },
|
||
{ id: 'trending', name: 'Trending', stat: 'attention', portal: 'trending' },
|
||
{ id: 'archive', name: 'Archive', stat: 'depth', portal: null },
|
||
{ id: 'featured-article', name: 'Featured Article', stat: 'depth', portal: 'featured-article' },
|
||
{ id: 'stub', name: 'Stub', stat: 'depth', portal: 'stub' },
|
||
{ id: 'translations', name: 'Translations', stat: 'reach', portal: null },
|
||
{ id: 'interwiki', name: 'Interwiki', stat: 'reach', portal: 'interwiki' },
|
||
{ id: 'disambiguation', name: 'Disambiguation', stat: 'reach', portal: 'disambiguation' },
|
||
];
|
||
|
||
/** DESIGN §9 v1.0 rules, frozen: the §12 golden match is pinned to these. */
|
||
export const RULESET_V1_0: Ruleset = {
|
||
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_TOPIC_POOL,
|
||
keywordParams: {
|
||
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 },
|
||
},
|
||
portalParams: {
|
||
'main-page': { amount: 1 }, trending: { factor: 2 }, 'featured-article': { amount: 2 },
|
||
stub: { value: 2 }, interwiki: { amount: 1 },
|
||
},
|
||
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, cultureKeyword: 'faction',
|
||
trendUp: 25, trendDown: -200, trendMinDaily: 20, uncheckedCostCap: 4,
|
||
factionSynergyCap: 3,
|
||
verifyStats: true,
|
||
percentiles: 'card-sample-2026-11-16',
|
||
starterDecks: 'default',
|
||
};
|
||
|
||
/**
|
||
* DESIGN §9 v1.1 (PR #32): config-only changes on top of v1.0. costThresholds are fame quantiles of the
|
||
* 236-card card-sample percentile table (#28), so they ship together with that table (shared/game/card-data.ts).
|
||
*/
|
||
export const RULESET_V1_1: Ruleset = {
|
||
...RULESET_V1_0,
|
||
version: '1.1',
|
||
costThresholds: [26, 39, 51, 63, 78],
|
||
cultureKeyword: 'home',
|
||
keywordParams: {
|
||
...RULESET_V1_0.keywordParams,
|
||
viral: { base: 1, amount: 1, cap: 3, powerDelta: 0 },
|
||
rising: { amount: 1, cap: 2, powerDelta: -1 },
|
||
encyclopedic: { amount: 2, sides: 1, powerDelta: 0 },
|
||
},
|
||
};
|
||
|
||
/** DESIGN §9 defaults: the current rules version (v1.1, BALANCE.md 00:45: ship #32 as is). */
|
||
export const DEFAULT_RULESET: Ruleset = RULESET_V1_1;
|