forked from WikiDeck/wikideck
Night 2 (2026-11-17), from the `claude/wikideck` fork's `night/2026-11-17` branch. It follows Night 1 (#22).
## What's in it
- **Duel engine** (fork #72, #80): 40-card decks of cards you own, Notability/Citations, keywords, effects T1–T12, Connected, a hidden-information-safe `viewFor`/`logFor`, and replay. Balance v1 tuning (#84) gives the first player about 51%.
- **Card profiles** (#70, #82): Figure, Location, Event, Institution or Doctrine, plus stats, keywords and rules text, all derived from real article data. Templates only.
- **Design and story** (#66, #69, #83): DUEL_DESIGN.md, plus the match log and the encyclopedic "Battle of X (2026)" recap.
- **PvP** (#74, #77, #81, #76, #85):
- The server checks ownership, and 40-card eligibility is enforced.
- Modes: Classic (ranked), Draft and Trending.
- Invites, quick match, Elo, a ladder and recap pages. Online matches render on the duel board.
- **Duel board UI** (#79): MTG-style card faces and combat declaration, built for 360 px first.
- **Polite Wikimedia client** (#73, #75): throttled, cached and identified requests, the mint-path fix, and a prefetch pool.
- **Android mining** (#78): native RandomX, as a sideload build. The emulator mined a testnet block.
- **Testnet ops** (#67, #68).
PR numbers refer to `claude/wikideck`.
## Status
- **Tests:** 423, of which 422 pass, 0 fail and 1 is skipped. The build is OK (`node:24-alpine`, `--network none`).
- **Testnet:** running this commit (036489c) on r350.
- **Untouched:** no changes to `server/testnet/consensus.ts`, `randomx.ts`, `native/` or the mainnet compose.
- **Review:** night-review reviewed fork #66–#79. #80–#85 came from the agents' unfinished branches and were not reviewed.
- **Known gaps:**
- The PvP end-to-end test hasn't been run (it needs two eom.dev accounts).
- Bot matches aren't reachable from Play.
- Card identity pre-bake hasn't been done.
- The RandomX verifier latch (`server/testnet/randomx.ts:140`) is still open.
This PR is for Eric to merge.
🤖 Generated with [Claude Code](https://claude.com/claude-code)Reviewed-on: WikiDeck/wikideck#23
Co-authored-by: Claude <claude@eom.dev>
49 lines
2.5 KiB
TypeScript
49 lines
2.5 KiB
TypeScript
// User-Agent for Wikimedia API requests. Wikimedia's User-Agent policy asks automated clients for a
|
|
// descriptive agent with contact details: `Tool/version (+https://site; contact) lib/version`.
|
|
// Operators set WIKIDECK_OPERATOR_CONTACT (an email address or URL); PUBLIC_ORIGIN is the fallback.
|
|
// WIKIDECK_USER_AGENT still overrides the whole string.
|
|
import { readFileSync } from 'node:fs';
|
|
|
|
export const PROJECT_URL = 'https://gitea.eom.dev/WikiDeck/wikideck';
|
|
const MAX_LENGTH = 256;
|
|
const SAFE = /^[\x20-\x7e]+$/;
|
|
|
|
function packageVersion(): string {
|
|
try {
|
|
const raw = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) as { version?: unknown };
|
|
return typeof raw.version === 'string' && /^[\w.+-]{1,32}$/.test(raw.version) ? raw.version : '0';
|
|
} catch { return '0'; }
|
|
}
|
|
const VERSION = packageVersion();
|
|
|
|
/** The operator contact, or undefined when none (or only an unsafe value) is configured. */
|
|
export function operatorContact(env: Record<string, string | undefined> = process.env): string | undefined {
|
|
for (const value of [env.WIKIDECK_OPERATOR_CONTACT, env.PUBLIC_ORIGIN]) {
|
|
const trimmed = value?.trim();
|
|
if (trimmed && trimmed.length <= 128 && SAFE.test(trimmed) && !/[();]/.test(trimmed)) return trimmed;
|
|
}
|
|
return undefined;
|
|
}
|
|
|
|
/** `WikiDeck/<version> (+<project URL>; <contact>) node/<version>`. */
|
|
export function defaultUserAgent(env: Record<string, string | undefined> = process.env): string {
|
|
const contact = operatorContact(env);
|
|
return `WikiDeck/${VERSION} (+${PROJECT_URL}${contact ? `; ${contact}` : ''}) node/${process.versions.node}`;
|
|
}
|
|
|
|
export function wikimediaUserAgent(fallback: string, env: Record<string, string | undefined> = process.env): string {
|
|
const configured = env.WIKIDECK_USER_AGENT?.trim();
|
|
// Reject header-injection/control characters and oversized values; fall back to the default.
|
|
if (!configured || configured.length > MAX_LENGTH || !SAFE.test(configured)) return fallback;
|
|
return configured;
|
|
}
|
|
|
|
/** Start-up check: Wikimedia throttles or blocks clients without contact details first. */
|
|
export function warnIfNoContact(env: Record<string, string | undefined> = process.env,
|
|
warn: (message: string) => void = console.warn): boolean {
|
|
if (wikimediaUserAgent('', env) || operatorContact(env)) return false;
|
|
warn('[wikimedia] WARNING: no operator contact in the Wikimedia User-Agent. Set WIKIDECK_OPERATOR_CONTACT '
|
|
+ '(an email address or URL) or PUBLIC_ORIGIN; Wikimedia policy requires it and may block this node.');
|
|
return true;
|
|
}
|