# Goddess Expansion — Implementation Tracker

Branch: `feat/goddess`

## Chunk 1 — Types ✅ COMPLETE
- [x] Add `GoddessZone`, `GoddessBoss`, `GoddessQuest` interfaces
- [x] Add `GoddessDisciple` (Disciples) interface
- [x] Add `GoddessEquipment`, `GoddessUpgrade` interfaces
- [x] Add `GoddessExplorationState` interface
- [x] Add `ConsecrationData` + `ConsecrationUpgrade` (Prestige) interfaces
- [x] Add `EnlightenmentData` + `EnlightenmentUpgrade` (Transcendence) interfaces
- [x] Add `GoddessAchievement` interface
- [x] Add goddess currency fields (prayers, divinity, stardust) to `Resource`
- [x] Add top-level `GoddessState` container + add `goddess?` to `GameState`
- [x] Export all new types from `packages/types`
- Lint ✅ · Build ✅ · Tests ✅ (100% coverage)

## Chunk 2 — Data
- [ ] `goddess-zones.ts` — goddess zone definitions
- [ ] `goddess-bosses.ts` — goddess boss definitions
- [ ] `goddess-quests.ts` — goddess quest definitions
- [ ] `goddess-disciples.ts` — disciple (adventurer) tier definitions
- [ ] `goddess-equipment.ts` — goddess equipment definitions
- [ ] `goddess-upgrades.ts` — goddess upgrade definitions
- [ ] `goddess-prestige-upgrades.ts` — consecration upgrade definitions
- [ ] `goddess-transcendence-upgrades.ts` — enlightenment upgrade definitions
- [ ] `goddess-crafting.ts` — goddess materials + recipes
- [ ] `goddess-explorations.ts` — goddess exploration areas
- [ ] `goddess-achievements.ts` — goddess achievement definitions

## Chunk 3 — Sync / Sanitize
- [ ] Update `validateAndSanitize` to inject goddess state defaults for existing saves
- [ ] Update force-sync (`syncNewContent`) to inject missing goddess fields
- [ ] Add apotheosis unlock flag handling

## Chunk 4 — API Routes
- [ ] Goddess boss fight route
- [ ] Consecration (goddess prestige) route
- [ ] Enlightenment (goddess transcendence) route
- [ ] Goddess upgrade purchase route
- [ ] Goddess crafting route
- [ ] Goddess exploration route

## Chunk 5 — UI: Resource Bar + Tab Row
- [ ] Add goddess currencies to resource bar dropdown (greyed pre-apotheosis)
- [ ] Add second tab row to nav (always visible, locked pre-apotheosis)
- [ ] `.goddess-mode` CSS class toggle on root when goddess tab active
- [ ] 300ms CSS fade transition between base and goddess themes

## Chunk 6 — UI: Goddess Panels
- [ ] `GoddessZonesPanel` — zones with lock states
- [ ] `GoddessBossPanel` — boss fights
- [ ] `GoddessQuestsPanel` — quests
- [ ] `DisciplesPanel` — goddess adventurers
- [ ] `GoddessEquipmentPanel` — equipment
- [ ] `GoddessUpgradesPanel` — upgrades
- [ ] `ConsecrationPanel` — goddess prestige
- [ ] `EnlightenmentPanel` — goddess transcendence
- [ ] `GoddessCraftingPanel` — crafting
- [ ] `GoddessExplorationPanel` — exploration
- [ ] `GoddessAchievementsPanel` — achievements

## Chunk 7 — Tick Engine
- [ ] Goddess passive income (prayers, divinity accumulation)
- [ ] Disciple passive income logic
- [ ] Lock state checks (no goddess income pre-apotheosis)
- [ ] Goddess quest timer logic

## Chunk 8 — CSS Theme
- [ ] Define goddess CSS variables (soft blue primary, gold/white accents)
- [ ] Apply `.goddess-mode` overrides to all themed elements
- [ ] Verify logo stays unchanged during theme shift
- [ ] Test fade transition smoothness

## Chunk 9 — About Page
- [ ] Update `HOW_TO_PLAY` array in `aboutPanel.tsx` with Goddess expansion documentation

## Notes
- Apotheosis = the unlock gate for all goddess content (replaces original "Transcendence 20" concept — verify exact trigger)
- Goddess currencies always visible in resource bar, greyed pre-apotheosis
- All goddess tabs always visible in second row, content locked internally pre-apotheosis
- Vampire Mode will follow same pattern as third tab row (future work, not this PR)
- Sync new content must inject goddess defaults for all existing saves