History: AI-driven alternate-history simulator

Pax Historia-style sim where the LLM is the world engine.

- React 19 + Vite 6 + Tailwind v4 + shadcn/ui frontend
- Express single-port backend (/api + /sse + built client + SPA fallback)
- SQLite (better-sqlite3) persistence, one row per game
- MapLibre choropleth map (OpenFreeMap dark + ISO_A3 regions)
- Defensive turn loop: strip fences, balanced-{} extract, parse, clamp 0-100,
  retry-once nudge, generic 'unclear' fallback; never crashes on bad output
- 5 seed presets (wwii-1939, coldwar-1955, modern-2025, no-wwii-1940, aegis-2400)
- LLM client over native fetch w/ injectable transport (mesh-bot pattern);
  LLM_STUB=1 deterministic transport for tests/e2e
- Unit (vitest, 19) + deterministic Playwright e2e
- Multi-stage node:22-slim Docker + Traefik (history.dev.kkhost.pl:4321)

Co-Authored-By: OpenCode <opencode@users.noreply.github.com>

src/lib/api.ts

@@ -0,0 +1,47 @@
+// Client-side API helper. All requests are same-origin relative paths (they are
+// proxied by Vite in dev and served by Express in prod), so no origin is ever
+// hardcoded — this works unchanged behind the Traefik proxy.
+import type { GameState, Preset, PresetMeta } from '@shared/types';
+import type { AdvisorResponse, CreateGameResponse, TurnResponse } from '@shared/protocol';
+
+async function req<T>(path: string, init?: RequestInit): Promise<T> {
+  const res = await fetch(path, {
+    headers: { 'content-type': 'application/json' },
+    ...init,
+  });
+  if (!res.ok) {
+    const body = (await res.json().catch(() => ({}))) as { error?: string };
+    throw new Error(body.error ?? `HTTP ${res.status}`);
+  }
+  return res.json() as Promise<T>;
+}
+
+export const api = {
+  listPresets: () => req<{ presets: PresetMeta[] }>('/api/presets'),
+  getPreset: (id: string) => req<{ preset: Preset }>(`/api/presets/${id}`),
+  createGame: (presetId: string, playerNationId: string) =>
+    req<CreateGameResponse>('/api/games', {
+      method: 'POST',
+      body: JSON.stringify({ presetId, playerNationId }),
+    }),
+  getGame: (id: string) => req<{ game: GameState }>(`/api/games/${id}`),
+  turn: (id: string, action?: string, chat?: { to: string; message: string }) =>
+    req<TurnResponse>(`/api/games/${id}/turn`, {
+      method: 'POST',
+      body: JSON.stringify({ action, chat }),
+    }),
+  jump: (id: string) =>
+    req<TurnResponse>(`/api/games/${id}/jump`, {
+      method: 'POST',
+      body: JSON.stringify({}),
+    }),
+  advisor: (id: string, prompt?: string) =>
+    req<AdvisorResponse>(`/api/games/${id}/advisor`, {
+      method: 'POST',
+      body: JSON.stringify({ prompt }),
+    }),
+  map: (id: string) =>
+    req<{ regions: Record<string, { color: string; owner: string; ownerId: string }> }>(
+      `/api/games/${id}/map`,
+    ),
+};