feat: sync rules with vault 2026-10-20 (borrowed mana, Odetchnięcie limit, Oszołomiony, Akcje Natychmiastowe)

Adds src/logic/rules.ts, counters, migration 1.4.0, III/IV mana swap, thaumaturgy school, tests, recompiled translations.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

src/logic/rules.ts

@@ -0,0 +1,174 @@
+/**
+ * Pure rule helpers from the 2026-10-20 vault sync (Foundry Sync Brief).
+ * No Foundry globals here, so everything is unit-testable.
+ *
+ * Rounding convention: everything fractional rounds UP, except
+ *   - new-spell mana cost (nearest, min 1),
+ *   - Nadczarowanie bonus from level 3 (halved, DOWN, min 1),
+ *   - fire damage with Hartowany w Ogniu (halved, DOWN).
+ */
+
+/** Odetchnięcie: at most twice between two Długie Odpoczynki. */
+export const MAX_BREATHERS_BETWEEN_LONG_RESTS = 2;
+
+/** Pożyczanie Many (Wyczerpanie Many) – tier table, N d6 summed. */
+export const MANA_EXHAUSTION_TIERS = [
+  { min: 1, max: 4, id: 'zdyszanie', label: 'Zdyszanie' },
+  { min: 5, max: 8, id: 'zmeczenie', label: 'Zmęczenie' },
+  { min: 9, max: 12, id: 'wyczerpanie', label: 'Wyczerpanie' },
+  { min: 13, max: 16, id: 'zalamanie-sil', label: 'Załamanie Sił' },
+  { min: 17, max: 20, id: 'zapasc', label: 'Zapaść' },
+  { min: 21, max: 24, id: 'ciezka-zapasc', label: 'Ciężka Zapaść' },
+  { min: 25, max: Infinity, id: 'wypalenie', label: 'Wypalenie' },
+] as const;
+
+export function manaExhaustionTier(total: number) {
+  return MANA_EXHAUSTION_TIERS.find((t) => total >= t.min && total <= t.max) ?? MANA_EXHAUSTION_TIERS[0];
+}
+
+/** Mana beyond the remaining pool that has to be "borrowed" for a cast. */
+export function manaToBorrow(cost: number, poolRemaining: number): number {
+  return Math.max(0, cost - Math.max(0, poolRemaining));
+}
+
+/** Number of d6 for the Wyczerpanie Many roll: cumulative borrowed mana incl. this cast. */
+export function exhaustionDice(borrowedSoFar: number, borrowedNow: number): number {
+  return Math.max(0, borrowedSoFar) + Math.max(0, borrowedNow);
+}
+
+/** Over-limit overcast: T by base cost, S = E(E+1)/2. */
+export function overLimitTest(baseCost: number, excess: number): { threshold: number; successes: number } {
+  const threshold = baseCost <= 2 ? 4 : baseCost <= 4 ? 5 : 6;
+  return { threshold, successes: (excess * (excess + 1)) / 2 };
+}
+
+/** Nadczarowanie bonus multiplier: levels 1–2 full, level 3+ halved DOWN, min 1. */
+export function overcastBonus(level: number, perLevel: number): number {
+  if (level <= 0) return 0;
+  if (level <= 2) return perLevel * level;
+  const full = perLevel * 2;
+  const tapered = Math.max(1, Math.floor(perLevel / 2));
+  return full + tapered * (level - 2);
+}
+
+/** Halve a rolled dice-bonus result for level 3+ overcast (DOWN, min 1). */
+export function taperedDiceBonus(rolled: number): number {
+  return Math.max(1, Math.floor(rolled / 2));
+}
+
+/** Zasada Potężniejszych Zaklęć: nadwyżka = caster's Sukcesy − S (min 0). */
+export function spellSurplus(casterSuccesses: number, required: number): number {
+  return Math.max(0, casterSuccesses - required);
+}
+export const defenderSuccessesNeeded = (surplus: number) => 1 + surplus;
+export const dispelSuccessesNeeded = (surplus: number, indestructible = false) =>
+  2 + surplus + (indestructible ? 1 : 0);
+
+/** Oszołomiony trigger: one hit costs at least half max Żywotność (after reductions). */
+export function triggersStun(healthLost: number, maxHealth: number): boolean {
+  return maxHealth > 0 && healthLost > 0 && healthLost * 2 >= maxHealth;
+}
+
+/** Koncentracja test: Dusza (Determinacja) 4:S, S = ⌈⅓ lost⌉, min 1. None if nothing lost. */
+export function concentrationTest(healthLost: number): { threshold: number; successes: number } | null {
+  if (healthLost <= 0) return null;
+  return { threshold: 4, successes: Math.max(1, Math.ceil(healthLost / 3)) };
+}
+
+/** Unik: positive difference means dodge failed; damage uses difference + 2. */
+export function dodgeResult(attackerSuccesses: number, defenderSuccesses: number) {
+  const diff = attackerSuccesses - defenderSuccesses;
+  return { hit: diff > 0, damageSuccesses: diff > 0 ? diff + 2 : 0 };
+}
+
+/** Parowanie (T−1): parried when parrier ≥ attacker − ⌈½ Walka Wręcz⌉. */
+export function parrySucceeds(parrierSuccesses: number, attackerSuccesses: number, melee: number): boolean {
+  return parrierSuccesses >= attackerSuccesses - Math.ceil(melee / 2);
+}
+
+/** Przewrócony: standing up costs half Ruch (rounded up). */
+export function standUpCost(movement: number): number {
+  return Math.ceil(movement / 2);
+}
+
+/** Spowolniony / Oszołomiony: Ruch halved, rounded up. */
+export function halvedMovement(movement: number): number {
+  return Math.ceil(movement / 2);
+}
+
+/** Szarża requires a straight Ruch of ≥ 4 m started outside the target's reach. */
+export const CHARGE_MIN_DISTANCE_M = 4;
+
+/** Immediate Actions: 1 free per round; 1 Zapał buys two extra. Returns Zapał cost of the n-th action (1-based). */
+export function immediateActionZealCost(nth: number): number {
+  if (nth <= 1) return 0;
+  const extra = nth - 1;
+  return Math.ceil(extra / 2);
+}
+
+/** Total Zapał for n Immediate Actions in one round. */
+export function immediateActionsZealTotal(n: number): number {
+  return n <= 1 ? 0 : Math.ceil((n - 1) / 2);
+}
+
+/** Źródło Mocy mana-passing test: T by distance 4/5/6 for <1/<2/<3 m. */
+export function manaPassThreshold(distanceM: number): number | null {
+  if (distanceM < 1) return 4;
+  if (distanceM < 2) return 5;
+  if (distanceM < 3) return 6;
+  return null;
+}
+
+/** Pomoc: regular mage contributes at most ⌈½ own Maksymalny Koszt⌉. */
+export function helpContributionCap(maxPerSpell: number, manaSource = false): number {
+  return manaSource ? maxPerSpell : Math.ceil(maxPerSpell / 2);
+}
+
+/** Wchłanianie Krwi: HP per Krew (2 base, 3 for Większe). */
+export function bloodAbsorbHp(blood: number, greater = false): number {
+  return Math.max(0, blood) * (greater ? 3 : 2);
+}
+/** Większe Wchłanianie Krwi: 1 Zapał per 5 Krew. */
+export function bloodToZeal(blood: number): number {
+  return Math.floor(Math.max(0, blood) / 5);
+}
+
+/** Eliksir Odnowienia Many: +3 mana (capped by the pool); quick use = 1d3 as Immediate Action. */
+export const MANA_ELIXIR_NORMAL = 3;
+export const MANA_ELIXIR_QUICK_DIE = 3;
+export function manaElixirGain(current: number, max: number, amount: number): number {
+  return Math.max(0, Math.min(amount, max - current));
+}
+
+/** Magiczny Pocisk (and similar): damage that reaches Żywotność after Pancerz is at least 1. */
+export function minOneAfterArmor(damage: number, armor: number): number {
+  return Math.max(1, damage - armor);
+}
+
+/** Trade (Złoto, Stal i Magia). */
+export const TRADE = {
+  companyFee: 5000,
+  companyTest: { threshold: 4, successes: 3 },
+  bribeTiers: [
+    { rate: 0.02, discount: 0.1 },
+    { rate: 0.05, discount: 0.2 },
+    { rate: 0.08, discount: 0.3 },
+  ],
+  minBribe: 500,
+  thresholdFloor: 2,
+  negotiationSuccessesPerStep: 4,
+  minigameFailureCost: 0.1,
+  /** Unconfirmed (brief §16.3) – keep configurable. */
+  eurRate: 4.36,
+} as const;
+
+/** Negotiation bands for the 4:1 test: successes → step (1–2, 3–4, 5–6, 7+). */
+export function negotiationBand(successes: number): number {
+  if (successes <= 0) return 0;
+  return Math.min(4, Math.ceil(successes / 2));
+}
+
+/** Przerażony: modifier on tests aimed at the fear source (T+1), 0 otherwise. */
+export function fearThresholdMod(sourceId: string | undefined, targetId: string | undefined): number {
+  return sourceId && targetId && sourceId === targetId ? 1 : 0;
+}