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>

docker-compose.yml

@@ -0,0 +1,28 @@
+services:
+  history:
+    build: .
+    image: history:latest
+    restart: unless-stopped
+    environment:
+      - PORT=4321
+      # Live LLM (default) reads LLM_API_BASE / LLM_MODEL. Set LLM_STUB=1 to use
+      # the deterministic stub instead (no model required). Both are optional env.
+      # - LLM_STUB=1
+    networks:
+      - dev_net
+    volumes:
+      - history-data:/app/data
+    # Shared Traefik (dev_traefik) routing — see ../PROXY.md. Plain HTTP only;
+    # TLS is terminated by the external proxy in front of this Traefik.
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.history.rule=Host(`history.dev.kkhost.pl`)"
+      - "traefik.http.routers.history.entrypoints=web"
+      - "traefik.http.services.history.loadbalancer.server.port=4321"
+
+networks:
+  dev_net:
+    external: true
+
+volumes:
+  history-data: