dostulata/initiative
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Implement the 023-clear-encounter feature that adds a clear encounter button with confirmation dialog to remove all combatants and reset round/turn counters, with the cleared state persisting across page refreshes

Browse Source 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Lukas
2026-03-09 13:43:42 +01:00
parent 11c4c0237e
commit 24198c25f1
19 changed files with 703 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
specs/023-clear-encounter/quickstart.md Normal file
View File

@@ -0,0 +1,42 @@
# Quickstart: 023-clear-encounter
## Overview
Add a "Clear Encounter" feature that resets the entire encounter state (removes all combatants, resets round to 1, resets turn to 0) with a single confirmed action.
## Key Files to Create
| File | Layer | Purpose |
|------|-------|---------|
| `packages/domain/src/clear-encounter.ts` | Domain | Pure function: clear encounter state |
| `packages/application/src/clear-encounter-use-case.ts` | Application | Orchestrates domain call via store |
| `packages/domain/src/__tests__/clear-encounter.test.ts` | Test | Domain function tests |
## Key Files to Modify
| File | Change |
|------|--------|
| `packages/domain/src/events.ts` | Add `EncounterCleared` event type |
| `packages/domain/src/index.ts` | Export `clearEncounter` + event type |
| `packages/application/src/index.ts` | Export `clearEncounterUseCase` |
| `apps/web/src/hooks/use-encounter.ts` | Add `clearEncounter` callback |
| `apps/web/src/persistence/encounter-storage.ts` | Handle empty encounter in `loadEncounter` |
| `apps/web/src/components/turn-navigation.tsx` | Add clear button |
| `apps/web/src/App.tsx` | Wire `clearEncounter` to TurnNavigation |
## Architecture Pattern
Follow the existing remove-combatant pattern:
1. **Domain** (`clearEncounter`): Pure function, takes `Encounter`, returns `{ encounter, events }` or `DomainError`
2. **Application** (`clearEncounterUseCase`): Gets encounter from store, calls domain function, saves result
3. **Web hook** (`useEncounter`): Adds `clearEncounter` callback with `window.confirm()` gate
4. **UI** (`TurnNavigation`): Renders clear button, calls `onClearEncounter` prop
## Dev Commands
```bash
pnpm vitest run packages/domain/src/__tests__/clear-encounter.test.ts # Run domain tests
pnpm check # Full merge gate
pnpm --filter web dev # Dev server
```