chore: add vampire expansion implementation TODO

TODO.md

@@ -0,0 +1,135 @@
+# Vampire Expansion — Implementation TODO
+
+Branch: `feat/expansions`
+
+Thematic currency names:
+- Gold → **Blood**
+- Essence → **Ichor**
+- Crystals → **Soul Shards**
+- Runestones → **Bloodstones**
+- Echoes → **Whispers**
+- Click action → **Hunt**
+- Adventurers → **Thralls**
+- Prestige → **Siring** (working name)
+- Transcendence → **The Awakening** (working name)
+- Apotheosis → **Eternal Sovereignty** (role ID: 1486144657023959180)
+
+CDN prefix for all vampire art: `https://cdn.nhcarrigan.com/elysium/vampire/<folder>/<id>.jpg`
+Local scratch dir (delete before committing): `img/vampire/`
+
+---
+
+## Phase 1 — Types
+
+- [ ] Add `VampireExpansionState` interface to `packages/types/src/interfaces/` mirroring full `GameState` structure (zones, bosses, quests, adventurers, upgrades, equipment, achievements, prestige, transcendence, apotheosis, exploration, resources, baseClickPower, lastTickAt, dailyChallenges, codex, autoQuest, autoBoss, autoAdventurer, companions, story)
+- [ ] Add `ExpansionsState` interface: `{ vampire?: VampireExpansionState }`
+- [ ] Add `expansions?: ExpansionsState` field to `GameState`
+- [ ] Export new types from `packages/types/src/index.ts`
+
+---
+
+## Phase 2 — Data files (vampire content)
+
+All data files go in `apps/api/src/data/vampire/`.
+Same content scale as base game; use vampire theming throughout.
+
+- [ ] `zones.ts` — 18 vampire-themed zones (crypts, blood forests, cursed castles, etc.)
+- [ ] `bosses.ts` — 72 vampire-themed bosses (4 per zone)
+- [ ] `quests.ts` — match base game quest count (~95); vampire-themed names/descriptions
+- [ ] `adventurers.ts` — 32 thrall tiers with progressive stats
+- [ ] `upgrades.ts` — match base game upgrade count (~57); vampire-themed
+- [ ] `equipment.ts` — match base game equipment count (~53); vampire-themed sets
+- [ ] `equipmentSets.ts` — vampire equipment sets
+- [ ] `achievements.ts` — match base game count (~40); vampire-themed conditions
+- [ ] `explorations.ts` — 72 areas across 18 vampire lore zones
+- [ ] `materials.ts` — match base game material count (~54); vampire-themed
+- [ ] `recipes.ts` — match base game recipe count (~36); vampire-themed
+- [ ] `prestigeUpgrades.ts` — 25 "Siring" upgrades
+- [ ] `transcendenceUpgrades.ts` — 15 "Awakening" upgrades
+- [ ] `dailyChallenges.ts` — 10 vampire daily challenges
+- [ ] `initialState.ts` — `initialVampireState()` function mirroring `initialGameState` structure
+
+---
+
+## Phase 3 — Art generation & CDN upload
+
+For each category below, generate images via Gemini API (`gemini-3-pro-image-preview`),
+save locally to `img/vampire/<folder>/`, upload to R2, then delete local files.
+
+Use soft-shaded anime style; vampire/gothic aesthetic; crimson/black/dark purple palette.
+
+- [ ] Zone banners (18) → `img/vampire/zones/` → CDN `vampire/zones/`
+- [ ] Boss portraits (72) → `img/vampire/bosses/` → CDN `vampire/bosses/`
+- [ ] Quest banners (match count) → `img/vampire/quests/` → CDN `vampire/quests/`
+- [ ] Adventurer/thrall portraits (32) → `img/vampire/adventurers/` → CDN `vampire/adventurers/`
+- [ ] Equipment icons (match count) → `img/vampire/equipment/` → CDN `vampire/equipment/`
+- [ ] Achievement icons (match count) → `img/vampire/achievements/` → CDN `vampire/achievements/`
+- [ ] Exploration area art (72) → `img/vampire/explorations/` → CDN `vampire/explorations/`
+- [ ] Material icons (match count) → `img/vampire/materials/` → CDN `vampire/materials/`
+- [ ] Story chapter banners (match count) → `img/vampire/story-chapters/` → CDN `vampire/story-chapters/`
+
+---
+
+## Phase 4 — API changes
+
+- [ ] Add `inGuild` to Prisma `Player` model → update `initialGameState` if needed (already done in #134 — verify migration)
+- [ ] Update Prisma schema: no DB changes needed (expansion state is inside the `GameState` JSON blob)
+- [ ] Update `initialState.ts` to include `expansions: {}` in `initialGameState`
+- [ ] Update `sync-new-content` debug route to inject/patch vampire expansion content when expansion is unlocked
+- [ ] Add vampire-specific unlock trigger: when base-game apotheosis count ≥ 1, set `expansions.vampire` to `initialVampireState()` and `unlocked: true`
+- [ ] Update the load endpoint to pass expansion state through to the client
+- [ ] Ensure prestige/transcendence/apotheosis routes only reset state for their own expansion (base game routes must NOT touch `expansions.*`)
+- [ ] Add vampire prestige, transcendence, and apotheosis routes (mirrors of base game routes, scoped to `expansions.vampire`)
+- [ ] Grant `Eternal Sovereignty` role (ID: `1486144657023959180`) on vampire apotheosis
+
+---
+
+## Phase 5 — Frontend changes
+
+### Expansion switcher
+- [ ] Add expansion toggle buttons below the Early Access warning in the sidebar
+- [ ] Always render all expansion buttons; disable any where `unlocked !== true`
+- [ ] Active expansion stored in React state (not game state); defaults to `"base"`
+- [ ] Switching expansion updates which data the UI panels display
+
+### Resource bar
+- [ ] Show ALL currencies from ALL expansions as separate labelled lines
+- [ ] Vampire currencies use distinct icons/colours (crimson tint for blood, etc.)
+- [ ] The "expand" button label shows the gold-equivalent currency of the active expansion
+
+### Thematic UI
+- [ ] When vampire expansion is active, swap labels: gold → Blood, essence → Ichor, etc.
+- [ ] Apply `.vampire-mode` CSS class to game container when vampire is active
+- [ ] Vampire colour palette: deep crimsons (`#5C0A1A`), rich crimson (`#C41E3A`), blacks, desaturated purples
+
+### Tick engine
+- [ ] Update `apps/web/src/engine/tick.ts` to compute passive income for all unlocked expansions every tick (not just base game)
+- [ ] Offline income calculation must also cover all expansions
+
+### Profile
+- [ ] Profile panel: tab stats by expansion (base game tab + one tab per unlocked expansion)
+- [ ] Show correct thematic prestige/transcendence/apotheosis badge names per expansion
+- [ ] Lifetime stats (gold earned, clicks, etc.) tracked separately per expansion
+
+### About / How to Play
+- [ ] Update `aboutPanel.tsx` `HOW_TO_PLAY` array to document the expansion system
+
+---
+
+## Phase 6 — Tests & CI
+
+- [ ] Unit tests for all new data files (at minimum, validate structure/required fields)
+- [ ] Unit tests for `initialVampireState()`
+- [ ] Tests for vampire unlock trigger route
+- [ ] Tests for vampire prestige/transcendence/apotheosis routes
+- [ ] Tests for updated tick engine (expansion income)
+- [ ] Maintain 100% coverage on `apps/api` and `packages/types`
+- [ ] Full pipeline: lint → build → test passing before PR
+
+---
+
+## Phase 7 — Final
+
+- [ ] Delete `img/vampire/` directory before committing
+- [ ] Update `MEMORY.md` with new content counts
+- [ ] Open PR → request review