Compose classic Nexus Skills with original Tech and Strongholds

This commit is contained in:
Quintine committed 2026-10-04 23:59:58 +11:00
1 parent 03aedc14d7
commit 449e27b415
17 files changed
+1764 -23

No files matched your search

@@ -0,0 +1,515 @@
import assert from 'node:assert/strict';
import {
applyAction, createGame, handLimit, initializeLeaderSkillsGameForAudit,
joinGame, newPlayer, viewGame, type Action, type Game, type Player,
} from '../game/engine';
import { territory } from '../game/board';
import type { Card } from '../game/cards';
import type { FactionId } from '../game/catalog';
import { LEADER_SKILL_CARDS, type LeaderSkillId } from '../game/leader-skill-cards';
import { quoteBattleResolution, type ResolutionCombatant } from '../game/battle-resolution-quote';
import { createTechTokens, ownedTech } from '../game/tech-tokens';
import { createStrongholdCards, type StrongholdId } from '../game/stronghold-cards';
import { nextStrongholdFactionsNativeStep } from './fixture-stronghold-factions';
export type NexusSkillsModulesBattleStep = { actor: string; action: Action };
export type NexusSkillsModulesBattleOptions = {
/** Original undealt authenticated CLI setup, or fresh classic lobby. Never redealt. */
initial?: Game;
advanced?: boolean;
seatIds?: string[];
tech?: boolean;
strongholds?: boolean;
kind?: Exclude<StrongholdId, 'hidden_mobile_stronghold'>;
ownerElites?: number;
/** Earn a second token through a real first-turn battle, never assign ownership. */
opponentTokens?: 'one' | 'several';
opponentNexus?: 'moritani';
skill?: LeaderSkillId;
band?: 'normal' | 'skilled';
ownerDial?: number;
support?: number;
opponentDial?: number;
opponentSupport?: number;
ownerWeapon?: Card['kind'];
ownerDefense?: Card['kind'];
opponentWeapon?: Card['kind'];
opponentDefense?: Card['kind'];
traitors?: 'owner' | 'opponent' | 'both';
counter?: boolean;
secondBattle?: boolean;
};
export type NexusSkillsModulesBattleFixture = {
initial: Game;
afterSetup: Game;
beforeFirstStorm: Game;
firstStormStep: NexusSkillsModulesBattleStep;
afterFirstStorm: Game;
warmupBeforeBattle?: Game;
warmupPlanActions?: NexusSkillsModulesBattleStep[];
warmupAfterBattle?: Game;
beforeFirstMentat: Game;
firstMentatStep: NexusSkillsModulesBattleStep;
afterFirstMentat: Game;
beforeAlliance: Game;
allianceActions: NexusSkillsModulesBattleStep[];
beforeDraw: Game;
drawAction: NexusSkillsModulesBattleStep;
afterDraw: Game;
beforeBattle: Game;
battleAction: NexusSkillsModulesBattleStep;
game: Game;
owner: string;
opponent: string;
observer: string;
partner: string;
trainer: string;
skill: LeaderSkillId;
band: 'normal' | 'skilled';
kind: Exclude<StrongholdId, 'hidden_mobile_stronghold'>;
key: string;
secondKey?: string;
counter?: string;
planActions: NexusSkillsModulesBattleStep[];
actions: NexusSkillsModulesBattleStep[];
staging: string[];
};
export function nexusSkillsModulesBattlePlayer(game: Game, actor: string): Player {
const player = game.players.find(seat => seat.id === actor);
assert.ok(player, `Missing original classic seat ${actor}`);
return player;
}
const clean = (game: Game) => !game.phaseOpening && !game.response && !game.decision;
/** Scoped original shuffle/action entropy; generic non-word requests retain native forwarding. */
function entropy<T>(operation: () => T, rolls: number[] = []): T {
const descriptor = Object.getOwnPropertyDescriptor(crypto, 'getRandomValues');
const native = crypto.getRandomValues.bind(crypto);
let cursor = 0;
crypto.getRandomValues = <V extends ArrayBufferView | null>(array: V): V => {
if (array instanceof Uint32Array) {
for (let index = 0; index < array.length; index++) array[index] = rolls[cursor++] ?? 0xffffffff;
} else Reflect.apply(native, crypto, [array]);
return array;
};
try { return operation(); }
finally {
if (descriptor) Object.defineProperty(crypto, 'getRandomValues', descriptor);
else Reflect.deleteProperty(crypto, 'getRandomValues');
}
}
function offerRolls(selected: LeaderSkillId[]): number[] {
const working = LEADER_SKILL_CARDS.map(card => card.id);
const remainder = working.filter(skill => !selected.includes(skill));
const desired = selected.flatMap(skill => [skill, remainder.shift()!]);
desired.push(...remainder);
const rolls: number[] = [];
for (let index = working.length - 1; index > 0; index--) {
const from = working.indexOf(desired[index]);
assert.ok(from >= 0 && from <= index);
rolls.push(Math.floor((from + 0.5) * 0x100000000 / (index + 1)));
[working[index], working[from]] = [working[from], working[index]];
}
return rolls;
}
export function nextNexusSkillsModulesBattleStep(game: Game): NexusSkillsModulesBattleStep | null {
if (clean(game) && game.nexusCards?.phase?.stage === 'drawing') {
const phase = game.nexusCards.phase;
const actor = phase.eligible.find(id => !phase.done.includes(id));
if (actor) return { actor, action: { type: 'nexusCardChoice', turn: game.turn,
card: game.nexusCards.cards!.hands[actor], choice: 'keep', ownRedraws: 0 } };
}
if (!game.phaseOpening && !game.response) {
const decision = game.decision;
if (decision?.kind === 'leaderSkillVisibility')
return { actor: decision.player, action: { type: 'leaderSkillVisibility', event: decision.event, hide: false } };
if (decision?.kind === 'mentatQuestion')
return { actor: decision.player, action: { type: 'decision', event: decision.event, decline: true } };
if (decision?.kind === 'wormRide')
return { actor: decision.player, action: { type: 'decision', accept: false } };
if (decision?.kind === 'nexusFremenCunningOffer' || decision?.kind === 'nexusFremenCunningRide')
return { actor: decision.player, action: { type: 'decision', event: decision.event, accept: false } };
if (decision?.kind === 'nexusChoamInspection')
return { actor: decision.player, action: { type: 'decision', event: decision.event, inspect: false } };
if (decision?.kind === 'moritaniRetention' && decision.source === 'nexus')
return { actor: decision.player, action: { type: 'decision', event: decision.event, keep: null } };
if (decision?.kind === 'techToken')
return { actor: decision.player, action: { type: 'decision', token: decision.choices[0] } };
if (decision?.kind === 'faceDance')
return { actor: decision.player, action: { type: 'decision', accept: false } };
if (decision?.kind === 'sukRescue') {
const choice = decision.options.map((option, index) => ({ index, saved: option.normal + option.elite, kept: !!option.kept }))
.sort((a, b) => b.saved - a.saved || Number(b.kept) - Number(a.kept))[0].index;
return { actor: decision.player, action: { type: 'decision', event: decision.event, choice } };
}
}
return nextStrongholdFactionsNativeStep(game);
}
export function stepNexusSkillsModulesBattle(game: Game, next = nextNexusSkillsModulesBattleStep(game)): Game {
assert.ok(next, 'Original private plan requires a human action');
return entropy(() => applyAction(game, next.actor, next.action));
}
export function advanceNexusSkillsModulesBattle(game: Game, until: (state: Game) => boolean,
actions: NexusSkillsModulesBattleStep[] = []): Game {
for (let count = 0; count < 1800; count++) {
if (until(game)) return game;
assert.notEqual(game.status, 'finished');
const next = nextNexusSkillsModulesBattleStep(game); assert.ok(next, 'Human plan boundary before requested state');
actions.push(structuredClone(next));
game = stepNexusSkillsModulesBattle(game, next);
}
throw Error('Original Skills/Nexus continuation did not reach its boundary');
}
/** Reorder undealt singleton Spice Cards only. Discards keep their original history. */
function orderSpice(game: Game, kinds: ('land' | 'worm')[], staging: string[]): void {
const remainder = [...game.spiceDeck];
const front = kinds.map(kind => {
const index = remainder.findIndex(card => kind === 'land' ? 'territory' in card : 'worm' in card);
assert.ok(index >= 0, `Original undealt ${kind} must still exist`);
return remainder.splice(index, 1)[0];
});
game.spiceDeck = [...front, ...remainder];
staging.push(`Controlled conserved original undealt Spice order: ${kinds.join(', ')}; not natural shuffle history`);
}
function reserveBoard(game: Game): void {
for (const seat of game.players) {
seat.reserves += Object.values(seat.forces).reduce((sum, count) => sum + count, 0);
seat.forces = {};
if (seat.elites) {
seat.elites.reserves += Object.values(seat.elites.forces).reduce((sum, count) => sum + count, 0);
seat.elites.forces = {};
}
if (seat.advisors) seat.advisors = {};
}
}
function place(game: Game, actor: string, key: string, count: number): void {
const seat = nexusSkillsModulesBattlePlayer(game, actor);
assert.ok(seat.reserves - (seat.elites?.reserves ?? 0) >= count);
seat.reserves -= count;
seat.forces[key] = (seat.forces[key] ?? 0) + count;
}
function hold(game: Game, actor: string, matches: (card: Card) => boolean, staging: string[], used: string[]): string {
const seat = nexusSkillsModulesBattlePlayer(game, actor);
let card = seat.hand.find(card => matches(card) && !used.includes(card.id));
if (!card) {
const from = game.deck.findIndex(card => matches(card) && !used.includes(card.id));
const donor = from < 0 ? game.players.find(seat => seat.hand.some(card => matches(card) && !used.includes(card.id))) : undefined;
assert.ok(from >= 0 || donor, 'Required original card must remain in deck/hand custody');
assert.ok(seat.hand.length < handLimit(seat));
card = from >= 0 ? game.deck.splice(from, 1)[0]
: donor!.hand.splice(donor!.hand.findIndex(card => matches(card) && !used.includes(card.id)), 1)[0];
seat.hand.push(card);
staging.push(`Conserved physical ${card.id}: ${donor?.id ?? 'original deck'} → ${actor} hand`);
}
used.push(card.id);
return card.id;
}
function traitor(game: Game, actor: string, identity: string, staging: string[]): void {
const seat = nexusSkillsModulesBattlePlayer(game, actor);
if (seat.traitors.includes(identity)) return;
const returned = seat.traitors[0];
const from = game.traitorReserve?.indexOf(identity) ?? -1;
const donor = game.players.find(seat => seat.traitors.includes(identity));
assert.ok(returned && (from >= 0 || donor));
if (from >= 0) game.traitorReserve!.splice(from, 1, returned);
else donor!.traitors[donor!.traitors.indexOf(identity)] = returned;
seat.traitors[0] = identity;
staging.push(`Conserved original traitor ${identity}: ${donor?.id ?? 'reserve'} exchanged for ${actor}'s ${returned}`);
}
/** Genuine original all14/base33/all12 setup → Storm → END Mentat → worm →
* reciprocal alliance → closing Emperor draw → movement → human battle plans.
* Only labeled conserved physical sources are relocated; no wallets, phases,
* turn, skill effects, module owners, earned receipts or outcomes are assigned. */
export function createNexusSkillsModulesBattleFixture(options: NexusSkillsModulesBattleOptions = {}): NexusSkillsModulesBattleFixture {
const advanced = options.advanced ?? options.initial?.advanced ?? true;
const band = options.band ?? 'skilled';
const tech = options.tech ?? !!options.initial?.techTokens;
const strongholds = options.strongholds ?? !!options.initial?.strongholdCards;
const kind = options.kind ?? 'arrakeen';
assert.ok(advanced || !strongholds, 'Original Stronghold Cards require Advanced rules');
const actions: NexusSkillsModulesBattleStep[] = [], staging: string[] = [];
let game: Game;
if (options.initial) game = structuredClone(options.initial);
else {
const ids = options.seatIds ?? ['emperor', 'guild', 'atreides', 'fremen'];
assert.ok(ids.length >= 3 && ids.length <= 6 && new Set(ids).size === ids.length);
const factions: FactionId[] = ['emperor', 'guild', 'atreides', 'fremen', 'harkonnen', 'beneGesserit'];
game = createGame('NEXUSSKILLSMODULESBATTLE', newPlayer(ids[0], factions[0], factions[0]), advanced, []);
for (let index = 1; index < ids.length; index++) joinGame(game, newPlayer(ids[index], factions[index], factions[index]));
}
assert.equal(game.advanced, advanced);
assert.deepEqual(game.expansions, []);
assert.ok(!game.homeworlds);
if (game.status === 'lobby') {
if (tech && !game.techTokens) game = stepNexusSkillsModulesBattle(game, { actor: game.host, action: { type: 'techTokens', enabled: true } });
if (strongholds && !game.strongholdCards) game = stepNexusSkillsModulesBattle(game, { actor: game.host, action: { type: 'strongholdCards', enabled: true } });
}
assert.equal(!!game.techTokens, tech); assert.equal(!!game.strongholdCards, strongholds);
if (tech) assert.deepEqual(game.techTokens, createTechTokens(game.status === 'setup' ? game.players : []));
if (strongholds) assert.deepEqual(game.strongholdCards, createStrongholdCards());
assert.ok(game.players.length >= 3 && game.players.length <= 6);
const owner = game.players.find(seat => seat.faction === 'emperor')?.id;
const opponent = game.players.find(seat => seat.faction === 'guild')?.id;
const observer = game.players.find(seat => seat.faction === 'atreides')?.id;
assert.ok(owner && opponent && observer);
const partner = game.players.find(seat => ![owner, opponent, observer].includes(seat.id))?.id ?? opponent;
const desiredSkill = options.skill ?? 'warmaster';
const passive: LeaderSkillId[] = ['sandmaster', 'smuggler', 'rihani-decipherer', 'prana-bindu-adept', 'killer-medic', 'master-of-assassins']
.filter(skill => skill !== desiredSkill) as LeaderSkillId[];
const selected = game.players.map(seat => seat.id === owner ? desiredSkill : passive.shift()!);
if (game.status === 'lobby') {
assert.ok(!game.leaderSkills, 'Never replace existing original skill custody');
game.nexusCards ??= { cards: null, phase: null };
assert.deepEqual(game.nexusCards, { cards: null, phase: null });
for (const seat of game.players) if (!seat.ready) game = stepNexusSkillsModulesBattle(game, { actor: seat.id, action: { type: 'ready' } });
game = entropy(() => initializeLeaderSkillsGameForAudit(game), offerRolls(selected));
}
assert.equal(game.status, 'setup', 'Only original fresh undealt setup/lobby is accepted');
assert.equal(game.turn, 1); assert.equal(game.phase, 0);
assert.ok(game.leaderSkills && game.nexusCards?.cards);
assert.equal(game.leaderSkills.assignments.length, 0);
const initial = structuredClone(game);
for (let count = 0; game.status === 'setup' && count < 240; count++) {
if (game.setupStage === 'leaderSkills') {
const actor: string = Object.keys(game.leaderSkills!.offers)[0];
const offer: NonNullable<Game['leaderSkills']>['offers'][string] = game.leaderSkills!.offers[actor];
const view = viewGame(game, actor).leaderSkills!;
const requested: LeaderSkillId = selected[game.players.findIndex(seat => seat.id === actor)];
const legal: LeaderSkillId[] = offer.cards.filter(skill => !view.unavailableSkills?.[skill]);
const skill: LeaderSkillId | undefined = legal.includes(requested) ? requested : legal[0];
assert.ok(skill, 'Existing saved offer has no legal original skill; it cannot be redealt');
if (actor === owner && options.skill) assert.equal(skill, options.skill, 'Requested skill must be in the original saved offer');
const eligible = new Set(view.eligibleLeaders.map(leader => leader.id));
const leader = nexusSkillsModulesBattlePlayer(game, actor).leaders.filter(leader => eligible.has(leader.id))
.sort((a, b) => b.strength - a.strength)[0];
assert.ok(leader);
const next: NexusSkillsModulesBattleStep = { actor, action: { type: 'leaderSkill', event: offer.event, skill, leader: leader.id } };
actions.push(next); game = stepNexusSkillsModulesBattle(game, next);
} else {
const next = nextNexusSkillsModulesBattleStep(game); assert.ok(next);
actions.push(next); game = stepNexusSkillsModulesBattle(game, next);
}
}
assert.equal(game.status, 'playing');
const afterSetup = structuredClone(game);
const assignment = game.leaderSkills!.assignments.find(skill => skill.owner === owner)!;
const skill = assignment.skill, trainer = assignment.leader;
let beforeFirstStorm!: Game, firstStormStep!: NexusSkillsModulesBattleStep, afterFirstStorm!: Game;
while (!(game.phase === 1 && clean(game))) {
const next = nextNexusSkillsModulesBattleStep(game); assert.ok(next);
const before = structuredClone(game);
actions.push(next); game = stepNexusSkillsModulesBattle(game, next);
if (tech ? JSON.stringify(before.techTokens) !== JSON.stringify(game.techTokens) : before.phase === 0 && game.phase === 1) {
beforeFirstStorm = before; firstStormStep = next; afterFirstStorm = structuredClone(game);
}
}
assert.ok(beforeFirstStorm && firstStormStep && afterFirstStorm);
orderSpice(game, ['land', 'land'], staging);
game = advanceNexusSkillsModulesBattle(game, state => state.phase === 5 && clean(state), actions);
reserveBoard(game);
staging.push('After actual setup, conserve all board counters through their own reserves before first movement completion');
let warmupBeforeBattle: Game | undefined, warmupPlanActions: NexusSkillsModulesBattleStep[] | undefined,
warmupAfterBattle: Game | undefined;
if (options.opponentTokens === 'several') {
assert.ok(tech, 'Multiple rewards require selected original Tech Tokens');
assert.equal(ownedTech(game.techTokens, opponent).length, 1);
const donor = game.players.find(seat => seat.id !== opponent && ownedTech(game.techTokens, seat.id).length === 1);
assert.ok(donor);
for (const actor of [opponent, donor.id]) place(game, actor, 'arrakeen:10', 5);
staging.push(`Conserved five ordinary counters each at Arrakeen for ${opponent}'s real first-turn token-winning battle against ${donor.id}`);
game = advanceNexusSkillsModulesBattle(game, state => state.phase === 6 && clean(state), actions);
const actor = game.active!; assert.ok([opponent, donor.id].includes(actor));
warmupBeforeBattle = structuredClone(game);
const choose: NexusSkillsModulesBattleStep = { actor, action: { type: 'chooseBattle', territory: 'arrakeen',
target: actor === opponent ? donor.id : opponent } };
actions.push(choose); game = stepNexusSkillsModulesBattle(game, choose);
game = advanceNexusSkillsModulesBattle(game, state => !nextNexusSkillsModulesBattleStep(state), actions);
const leader = (id: string, strongest: boolean) => {
const candidates = nexusSkillsModulesBattlePlayer(game, id).leaders.filter(disc => !disc.dead && !disc.usedAt &&
!game.leaderSkills!.assignments.some(assignment => assignment.leader === disc.id));
candidates.sort((a, b) => strongest ? b.strength - a.strength : a.strength - b.strength);
assert.ok(candidates[0]); return candidates[0].id;
};
warmupPlanActions = [
{ actor: opponent, action: { type: 'battlePlan', leader: leader(opponent, true), dial: 4,
support: advanced ? 4 : 0, weapon: null, defense: null } },
{ actor: donor.id, action: { type: 'battlePlan', leader: leader(donor.id, false), dial: 0,
support: 0, weapon: null, defense: null } },
];
for (const plan of warmupPlanActions) {
actions.push(plan); game = stepNexusSkillsModulesBattle(game, plan);
while (game.response || game.phaseOpening || game.decision?.kind === 'fullPlanOffer') {
const next = nextNexusSkillsModulesBattleStep(game); assert.ok(next);
actions.push(next); game = stepNexusSkillsModulesBattle(game, next);
}
}
game = finishNexusSkillsModulesBattle(game);
assert.equal(game.lastBattleContext!.winner, opponent);
assert.equal(ownedTech(game.techTokens, opponent).length, 2);
warmupAfterBattle = structuredClone(game);
}
game = advanceNexusSkillsModulesBattle(game, state => state.phase === 8 && clean(state), actions);
if (strongholds) {
reserveBoard(game);
place(game, owner, `${kind}:${territory(kind).sectors[0]}`, 1);
staging.push(`Conserved one ordinary claimant at ${kind} before actual END Mentat; no Stronghold owner grant`);
}
let beforeFirstMentat!: Game, firstMentatStep!: NexusSkillsModulesBattleStep;
while (game.turn === 1) {
const next = nextNexusSkillsModulesBattleStep(game); assert.ok(next);
const before = structuredClone(game);
actions.push(next); game = stepNexusSkillsModulesBattle(game, next);
if (game.turn === 2) { beforeFirstMentat = before; firstMentatStep = next; }
}
const afterFirstMentat = structuredClone(game);
if (strongholds) assert.equal(game.strongholdCards!.owners[kind], owner);
game = advanceNexusSkillsModulesBattle(game, state => state.phase === 1 && clean(state), actions);
orderSpice(game, ['worm', 'land', 'land'], staging);
game = advanceNexusSkillsModulesBattle(game, state => state.nexus === true && !state.spiceWindow && clean(state), actions);
const beforeAlliance = structuredClone(game);
const allianceActions: NexusSkillsModulesBattleStep[] = [
{ actor: observer, action: { type: 'alliance', target: partner } },
{ actor: partner, action: { type: 'alliance', target: observer } },
];
for (const next of allianceActions) { actions.push(next); game = stepNexusSkillsModulesBattle(game, next); }
game = advanceNexusSkillsModulesBattle(game, state => state.nexusCards?.phase?.stage === 'drawing', actions);
const cards = game.nexusCards!.cards!;
const from = cards.deck.indexOf('emperor'); assert.ok(from >= 0);
cards.deck.unshift(cards.deck.splice(from, 1)[0]);
staging.push('Conserved undealt Emperor Nexus singleton ordered first after genuine alliance; only actual closing draw changes hand custody');
const beforeDraw = structuredClone(game);
const drawAction: NexusSkillsModulesBattleStep = { actor: owner, action: {
type: 'nexusCardChoice', turn: game.turn, card: cards.hands[owner], choice: 'draw', ownRedraws: 0,
} };
actions.push(drawAction); game = stepNexusSkillsModulesBattle(game, drawAction);
const afterDraw = structuredClone(game);
assert.equal(game.nexusCards!.cards!.hands[owner], 'emperor');
if (options.opponentNexus) {
const cards = game.nexusCards!.cards!;
assert.ok(game.nexusCards!.phase?.eligible.includes(opponent), 'Requested original opponent draw requires an unallied closing recipient');
const from = cards.deck.indexOf(options.opponentNexus); assert.ok(from >= 0);
cards.deck.unshift(cards.deck.splice(from, 1)[0]);
const draw: NexusSkillsModulesBattleStep = { actor: opponent, action: { type: 'nexusCardChoice', turn: game.turn,
card: cards.hands[opponent], choice: 'draw', ownRedraws: 0 } };
staging.push('Conserved undealt Moritani singleton ordered before Guild’s actual unallied closing draw');
actions.push(draw); game = stepNexusSkillsModulesBattle(game, draw);
assert.equal(game.nexusCards!.cards!.hands[opponent], 'moritani');
}
game = advanceNexusSkillsModulesBattle(game, state => state.phase === 5 && clean(state), actions);
reserveBoard(game);
const key = `${kind}:${territory(kind).sectors[0]}`;
assert.ok(!territory(kind).sectors.includes(game.storm));
for (const actor of [owner, opponent]) place(game, actor, key, 7);
const eliteCount = options.ownerElites ?? 0;
if (eliteCount) {
const seat = nexusSkillsModulesBattlePlayer(game, owner);
assert.ok(seat.elites && Number.isInteger(eliteCount) && eliteCount > 0 && seat.elites.reserves >= eliteCount);
seat.reserves -= eliteCount; seat.elites.reserves -= eliteCount;
seat.forces[key] += eliteCount; seat.elites.forces[key] = eliteCount;
staging.push(`Conserved ${eliteCount} actual starred Sardaukar from own reserves to ${key}; distinct from the five temporary ordinary roles`);
}
const secondKey = options.secondBattle ? `carthag:${territory('carthag').sectors[0]}` : undefined;
if (secondKey) {
assert.ok(!territory('carthag').sectors.includes(game.storm));
for (const actor of [owner, opponent]) place(game, actor, secondKey, 1);
}
staging.push(`Before actual turn-two movement completion, conserved seven ordinary counters per combatant at ${kind}; any starred counters are separately labeled`);
if (secondKey) staging.push('Conserved one further ordinary counter per combatant at Carthag for genuine same-turn expiry battle');
const used: string[] = [];
const card = (actor: string, kind: Card['kind'] | undefined) => kind ? hold(game, actor, card => card.kind === kind, staging, used) : null;
const ownerWeapon = card(owner, options.ownerWeapon ?? (skill === 'warmaster' ? 'worthless' : undefined));
const ownerDefense = card(owner, options.ownerDefense);
const opponentWeapon = card(opponent, options.opponentWeapon);
const opponentDefense = card(opponent, options.opponentDefense);
const counter = options.counter ? hold(game, opponent, card => card.effect === 'karama', staging, used) : undefined;
const untrained = (actor: string) => {
const leaders = nexusSkillsModulesBattlePlayer(game, actor).leaders.filter(leader => !leader.dead && !leader.usedAt &&
!game.leaderSkills!.assignments.some(assignment => assignment.leader === leader.id));
const leader = leaders.find(leader => leader.strength === 3) ?? leaders[0]; assert.ok(leader);
return leader.id;
};
const ownerLeader = band === 'skilled' ? trainer : untrained(owner);
const opponentLeader = untrained(opponent);
if (options.traitors === 'owner' || options.traitors === 'both') traitor(game, owner, opponentLeader, staging);
if (options.traitors === 'opponent' || options.traitors === 'both') traitor(game, opponent, ownerLeader, staging);
game = advanceNexusSkillsModulesBattle(game, state => state.phase === 6 && clean(state), actions);
const beforeBattle = structuredClone(game);
const actor = game.active!; assert.ok([owner, opponent].includes(actor));
const battleAction: NexusSkillsModulesBattleStep = { actor, action: { type: 'chooseBattle', territory: kind, target: actor === owner ? opponent : owner } };
actions.push(battleAction); game = stepNexusSkillsModulesBattle(game, battleAction);
const planActions: NexusSkillsModulesBattleStep[] = [
{ actor: owner, action: { type: 'battlePlan', leader: ownerLeader, dial: options.ownerDial ?? 6,
support: advanced ? options.support ?? 3 : 0, weapon: ownerWeapon, defense: ownerDefense } },
{ actor: opponent, action: { type: 'battlePlan', leader: opponentLeader, dial: options.opponentDial ?? 0,
support: advanced ? options.opponentSupport ?? 0 : 0, weapon: opponentWeapon, defense: opponentDefense } },
];
return { initial, afterSetup, beforeFirstMentat, firstMentatStep, afterFirstMentat, beforeAlliance, allianceActions,
beforeDraw, drawAction, afterDraw, beforeBattle, battleAction, game, owner, opponent, observer, partner,
beforeFirstStorm, firstStormStep, afterFirstStorm, warmupBeforeBattle, warmupPlanActions, warmupAfterBattle,
trainer, skill, band, kind, key, secondKey, counter, planActions, actions, staging };
}
export function prepareNexusSkillsModulesBattle(fixture: NexusSkillsModulesBattleFixture, state = fixture.game): Game {
let game = structuredClone(state);
for (let count = 0; count < 160; count++) {
const next = nextNexusSkillsModulesBattleStep(game);
if (!next) { assert.ok(game.battle && !game.battle.revealed); return game; }
if (next.action.type === 'leaderSkillVisibility') next.action.hide = next.actor === fixture.owner && fixture.band === 'skilled';
game = stepNexusSkillsModulesBattle(game, next);
}
throw Error('Original skill posture/private plan boundary did not open');
}
export function beginNexusSkillsModulesCunning(fixture: NexusSkillsModulesBattleFixture, state = prepareNexusSkillsModulesBattle(fixture)): Game {
const offer = viewGame(state, fixture.owner).nexusSardaukar?.offer;
assert.ok(offer); assert.equal(offer.blocked, null);
return stepNexusSkillsModulesBattle(state, { actor: fixture.owner, action: { type: 'nexusSardaukar', event: offer.event } });
}
export function revealNexusSkillsModulesBattle(fixture: NexusSkillsModulesBattleFixture,
options: { state?: Game; cunning?: boolean } = {}): Game {
let game = prepareNexusSkillsModulesBattle(fixture, options.state ?? fixture.game);
if (options.cunning) game = advanceNexusSkillsModulesBattle(beginNexusSkillsModulesCunning(fixture, game), clean);
for (const plan of fixture.planActions) {
game = stepNexusSkillsModulesBattle(game, plan);
while (game.response || game.phaseOpening || game.decision?.kind === 'fullPlanOffer') game = stepNexusSkillsModulesBattle(game);
}
assert.ok(game.battle?.revealed);
return game;
}
export function finishNexusSkillsModulesBattle(state: Game,
options: { stop?: 'losses' | 'rescue' | 'cleanup' | 'tech' | 'retention' | 'inspection'; callers?: string[] } = {}): Game {
let game = structuredClone(state);
for (let count = 0; count < 240; count++) {
if (options.stop === 'losses' && game.decision?.kind === 'battleLosses') return game;
if (options.stop === 'rescue' && game.decision?.kind === 'sukRescue') return game;
if (options.stop === 'cleanup' && game.decision?.kind === 'battleCards') return game;
if (options.stop === 'tech' && game.decision?.kind === 'techToken') return game;
if (options.stop === 'retention' && game.decision?.kind === 'moritaniRetention') return game;
if (options.stop === 'inspection' && game.decision?.kind === 'nexusChoamInspection') return game;
if (!game.battle && clean(game) && !game.pendingTreacheryDiscard) return game;
const next = nextNexusSkillsModulesBattleStep(game); assert.ok(next);
if (next.action.type === 'traitorCall') next.action.call = options.callers?.includes(next.actor) ?? false;
game = stepNexusSkillsModulesBattle(game, next);
}
throw Error('Original Skills/Nexus battle aftermath did not finish');
}
/** Quote the actual native source, including physical temporary roles and skill posture. */
export function quoteNexusSkillsModulesBattle(game: Game) {
const battle = game.battle; assert.ok(battle?.revealed);
const side = (actor: string): ResolutionCombatant => {
const seat = nexusSkillsModulesBattlePlayer(game, actor), view = viewGame(game, actor).battle!;
assert.ok(view.ownForces);
return { id: actor, faction: seat.faction, ally: seat.ally, spice: seat.spice, hand: seat.hand,
plan: battle.plans[actor], leader: seat.leaders.find(leader => leader.id === battle.plans[actor].leader),
forces: view.ownForces, stronghold: view.strongholdEffects[actor],
leaderSkills: game.leaderSkills!.assignments.filter(assignment => assignment.owner === actor)
.map(assignment => ({ skill: assignment.skill, leader: assignment.leader,
faceUp: !battle.leaderSkillHidden?.[actor], captured: false })) };
};
return quoteBattleResolution({ advanced: game.advanced, turn: game.turn, territory: battle.territory,
aggressor: viewGame(game, game.host).battle!.aggressor, attacker: side(battle.attacker), defender: side(battle.defender),
voters: viewGame(game, game.host).battle!.traitorVoters.map(actor => ({ id: actor,
beneficiary: [battle.attacker, battle.defender].includes(actor) ? actor : nexusSkillsModulesBattlePlayer(game, actor).ally!,
called: battle.traitorCalls[actor] ?? false, traitors: nexusSkillsModulesBattlePlayer(game, actor).traitors })),
participants: game.players, physicalCards: [...game.deck, ...game.discard, ...game.players.flatMap(seat => seat.hand)],
pendingAuditorPresent: false, pendingRetentionPresent: false, nexusMoritani: true });
}