WikiDeck Nights 1 + 2: 40-card duel, PvP, ownership, polite Wikimedia client, Android mining #86

Closed
claude wants to merge 121 commits from night/2026-11-17 into main
Owner

This brings everything from the two overnight agent runs into main. It is the night/2026-11-17 integration branch, which already contains Night 1's work.

Night 2 (2026-11-17), the 40-card Magic-style duel

  • Duel engine (#72 contracts, #80 engine): 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, no LLM.
  • 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 the collection API enforces 40-card eligibility.
    • Modes: Classic (ranked), Draft and Trending.
    • Invites, quick match, Elo, a ladder and recap pages, with the duel board rendering online matches.
  • 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 on Android, as a sideload build. The emulator mined a testnet block.
  • Testnet ops (#67, #68): autodeploy and the card identity store.

Night 1 (2026-11-16)

The Edit War lane game, Play section, bots, Dex SSO and wallet linking, peer-hosted game modes, the Android app and the private testnet. Details are in the Night 1 PRs (#11–#52).

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 exact commit on r350 (192.168.1.32:3101–3103).
  • Review: night-review reviewed #66–#79. #80–#85 were opened from the agents' wip branches on 2026-11-18 and were not reviewed (see the PR bodies).
  • 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.

Nothing here touches consensus or mainnet config. This PR is for Eric to merge.

🤖 Generated with Claude Code

This brings everything from the two overnight agent runs into `main`. It is the `night/2026-11-17` integration branch, which already contains Night 1's work. ## Night 2 (2026-11-17), the 40-card Magic-style duel - **Duel engine** (#72 contracts, #80 engine): 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, no LLM. - **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 the collection API enforces 40-card eligibility. - Modes: Classic (ranked), Draft and Trending. - Invites, quick match, Elo, a ladder and recap pages, with the duel board rendering online matches. - **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 on Android, as a sideload build. The emulator mined a testnet block. - **Testnet ops** (#67, #68): autodeploy and the card identity store. ## Night 1 (2026-11-16) The Edit War lane game, Play section, bots, Dex SSO and wallet linking, peer-hosted game modes, the Android app and the private testnet. Details are in the Night 1 PRs (#11–#52). ## 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 exact commit on r350 (192.168.1.32:3101–3103). - **Review:** night-review reviewed #66–#79. #80–#85 were opened from the agents' wip branches on 2026-11-18 and were not reviewed (see the PR bodies). - **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. Nothing here touches consensus or mainnet config. This PR is for Eric to merge. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
claude added 121 commits 2026-11-18 16:23:30 +00:00
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>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Refs #55.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Engine-agnostic duel bots over a DuelLens, a 40-card deck builder from the
236 sample cards with type/curve-skewed archetypes, a <=4-worker sim runner
and DUEL_BALANCE metrics. Runs on a small stand-in duel engine until
duel-core's shared/duel alpha lands; then shared/bots/duel-adapter.ts binds it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
server/game/identity.ts freezes each card's off-chain identity (P31, categories,
country, dates, coords, outlinks hash) once per tokenId in node:sqlite and never
rewrites it. scripts/night2/prebake-identity.ts reads the canonical chain from one
node and freezes from cached card files only; live facts plug in via an
IdentitySource on the wikimedia client's background lane (#62). Tests make zero
network calls. docs/night2/TESTNET.md: nodes, wallets, login, mining, autodeploy.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- server/game/ownership.ts: verifyAccount, resolveDeck (token ids only; canonical
  owner in linked wallets, confirmations, exact deckSize, 4 copies per pageId,
  cards rebuilt from their block), collection (all linked wallets, paged at one
  tip, no 128-block cap). Signature agreed with host-pvp on #57.
- server/game/collection.ts: GET /api/game/collection (Dex bearer) with owned,
  playable, needed, eligible.
- account router exports accountVerifier; http.ts shares one AccountStore and
  DexKeys between the account and game routes and passes gameRouter({ownership}).
- App.tsx: My collection counts cards in every wallet linked to the account.
- tests/ownership-deck.test.ts: in-memory ledger fixture, no network.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
shared/duel/classify.ts: Q-id anchors -> P31 label regex (^human$) -> P279 -> categories -> description -> Doctrine.
shared/duel/derive.ts: pure derive(chain, profile) -> DuelCard: fame cost 1-6, P+T budget per cost,
DUEL_DESIGN §4 keywords (<=2, Figures only, taxed), Portals, Connected keys and tiers, flavour.
shared/duel/effects.ts + text.ts: T1-T12 templates as EffectSpec data, MTG-register rules text.
shared/duel/sample.ts + docs/game/duel-card-sample.json: 236-card DuelCard fixture.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Presentational board on its own view model (src/game/duel/model.ts), 360 x 740 first:
both players' Notability, Citations, library and hand always visible; attack in one
tap, block in two, preview then confirm; tap-to-zoom card sheet with rules text,
flavour and an [n] article link; log ticker on phones, log column on desktop.
#duel-preview renders static scenes from card-sample.json for review.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Connected computed by the engine from frozen connect keys; tokens, fight,
multi-target plays, locationsPerTurn, timeoutsToConcede.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- server/wikimedia/client.ts: one process-wide client. Per-host token bucket
  (1 req/s, burst 3), 1 in flight per host, mint > interactive > background
  lanes with a bounded queue, maxlag=5 on Action API requests, Retry-After
  and backoff, a circuit breaker after 3 consecutive 429s, a daily cap, and
  a per-egress-IP budget (WIKIDECK_WIKIMEDIA_NODES_PER_IP).
- server/wikimedia/cache.ts: node:sqlite HTTP cache with ETag/If-None-Match,
  stale-while-revalidate on the background lane. Mint reads never use it.
- Mint fix: a 429/5xx/timeout/non-JSON reply on pageviews now fails getFresh()
  (template 503, miner retries) instead of minting attention: null forever.
- server/wikimedia/pool.ts: per-tip article+snapshot prefetch pool for
  /api/mining/template, about 3 requests per block regardless of miner count.
- User-Agent with an operator contact (WIKIDECK_OPERATOR_CONTACT or
  PUBLIC_ORIGIN) and a start-up warning when it is unset.
- Mint request parameters are byte-identical apart from maxlag (golden test).
  No consensus, block or protocol changes. Tests use fake fetch only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Board intents expand to duel-core's atomic actions (toggleAttacker x N,
confirmAttack; block x N, confirmBlocks), sent in order and awaited.
Fallback log uses the first DUEL_DESIGN 8.2 variant until the story
renderer reads engine events.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- src/game/collection/: collection model (GET /api/game/collection, local fallback), 40-card
  eligibility with the 4-per-article copy limit, "23 / 40 cards. Mine to play" gate, constructed
  deck picker. No loaners, starters or borrowed decks (BRIEF decisions 1-2).
- PlaySection: PvP hub with quick match, private lobby + invite link, join by link, ladder;
  bot match slot waits for ui-duel's board.
- online.ts / OnlinePlay.tsx: duel PvP client against host-pvp's routes (idToken in body,
  Bearer seat token, ?v= polling with 204), validated responses.
- Leaderboards: Elo ladder with W/L fallback.
- src/game/recap/: /battle/<id> (and /recap/<id>) standalone page rendering duel-design's
  RecapDoc shape; deterministic template fallback over real match data until #69 merges.
- App: /play/invite/<code> and /battle/<id> deep links; session.idToken().
- tests/ui-pvp-*.test.ts, tests/e2e/ui-pvp-smoke.mjs (Playwright, stubbed API).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Attaches duel: DuelCard to collection cards when the server has a frozen
profile (requested by ui-duel); omitted while pending, never fetches.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Mode schema wikideck.mode/2: required `engine` (editwar | duel); Night 1
  wikideck.mode/1 documents are rejected with a clear message. Deck policies:
  constructed (owned NFT token ids, minConfirmations), starter (Edit War only),
  draft with source preview (Edit War only) or collections. limits.rated and
  limits.accountsOnly.
- ModeHost runs every engine it is given, chosen per mode. Duel modes refuse
  loaner policies at startup (BRIEF decision 1).
- Seats: eom.dev account via Dex ID token (body or JWT bearer on seat-creating
  routes), player id sha256('acct:'+iss+'\n'+sub); guests only in Edit War.
- Constructed decks resolved through an injected OwnershipPort (#57), cards built
  by the engine's fromChain; creator's deck re-resolved at join.
- Private lobbies + invite codes (GET /invites/:code, POST /invites/:code/join),
  quick match (POST /modes/:id/quick), lobby state version with 204 on ?v=.
- Elo (1200, K 24) per mode for rated account-vs-account matches, recomputed
  from matches.jsonl; records carry engine, rated, tokens. /modes/:id/ladder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- scripts/build-randomx-android.sh: NDK cross-build of the pinned native/ engine
  (light mode) for arm64-v8a and x86_64, packaged as jniLibs/<abi>/libwikideck_randomx.so
- MinerPlugin.java (Capacitor "WikiDeckMiner"): runs engine processes over the
  line protocol, on-device self-test, and halts on background, battery saver,
  thermal, hot or low battery. Never receives wallet keys.
- src/mobile-miner.ts: template -> mine -> sign -> submit loop in the WebView,
  byte-identical to consensus miningBlob/mintId (tests/mobile-mining-miner.test.ts)
- src/MobileMiningPanel.tsx: consent, intensity (1 thread default; Max = 4 only
  while charging), live hashrate/status; testnet-only (disabled on mainnet builds)
- docs/night2/MOBILE_MINING.md: how it works, safeguards, measured hashrate,
  store policies (sideload APK only), options for Eric

No protocol, consensus or server changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Re-resolve the creator's deck before seating the joiner, so a stale lobby
expires without listing the joiner, and quick match moves on to the next
candidate (or opens a lobby) instead of failing the quick-matcher.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
contract.ts copies the unions and fields verbatim; a compile check confirmed
duel-core's PlayerView, DuelAction (both ways), LogEvent, DuelEngineApi and
DuelRuleset are assignable to it. It becomes re-exports once #72 merges.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Effect interpreter for DUEL_DESIGN T1-T12, keywords, Connected/rivalry,
tokens, fight, Doctrines, Garrisons, turnCap, timeouts. Structural
clone-on-apply (~0.05 ms/action). Refs #55.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Checked locally against duel-core's engine-wip: 40 full games through the board
pipeline (adapter, declaration reducers, expand) with every sent action legal.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Found by rendering duel-core's engine-wip mid-game locally.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
wikimediaIdentitySource() takes the wikimedia client (#73), the page enrichment and
duel-cards' profile builder (#70) as structural deps, so it imports nothing unmerged.
About 2 Wikidata requests per 50 new cards; transport failures leave cards unknown.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Not a PR yet: needs #72 (contracts) and the engine alpha to merge first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
An empty profile typed every card as Doctrine (night-review on #61). derive() now passes
chain.article to classify/subtypeFor; full-profile results are unchanged (fixture identical).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts:
#	shared/duel/effects.ts
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts:
#	server/game/index.ts
# Conflicts:
#	src/App.tsx
claude closed this pull request 2026-11-18 16:25:23 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: claude/wikideck#86