# thoughts.md

## Current Status (clean-break)
- Backend is running the new contract-native API shape:
  - `GET /api/state` -> `{ worldState, turns }`
  - `POST /api/turn` -> `{ rawText, actions, validation, worldState }`
- Runtime blocker is resolved:
  - old SQLite schema conflict (`turns.raw_text`) was fixed by wiping old DB state
  - stale legacy files removed from backend source tree:
    - `app/src/types.ts`
    - `app/src/latentEntities.ts`
    - `app/src/llmAdapter.ts`
- Door/key MVP smoke checks pass:
  - `open door` before key -> `locked_requires_key`
  - `take key` -> success
  - `open door` after key -> success

## Architecture Now
- Core contracts in `app/src/contracts/`:
  - `action.ts`
  - `validation.ts`
  - `turn.ts`
  - `entity.ts`
  - `world.ts`
- Deterministic truth engine:
  - `app/src/truthEngine.ts` with `validateActions(actions, worldState)`
- Ordered turn pipeline:
  - `app/src/turns/processTurn.ts` parse -> validate -> apply -> persist
- World mutation:
  - `app/src/world/applyActions.ts`
- Persistence:
  - `app/src/db.ts` with tables `turns`, `actions`, `validation_results`, `entities`, `world_states`
- App seed domain:
  - `app/src/app.ts` door/key world (`room_start`, `room_exit`, `player`, `door_1`, `key_1`)

## New Endpoint
- Added `POST /api/reset` in `app/src/index.ts`
- App-level reset implementation in `app/src/app.ts`
- DB wipe support in `app/src/db.ts`
- Verified reset behavior:
  - returns `{ worldState, turns }`
  - `turns` is empty after reset
  - `player` and `key_1` return to `room_start`

## Frontend Migration Notes
- `frontend/src/App.tsx` migrated to consume new backend contracts.
- Removed dependencies on old fields (`narration`, `events`, `beliefs`, `summaries`, `parser_feedback`).
- Turn submit flow now refreshes snapshot via `GET /api/state` after `POST /api/turn`.
- Reset call now sends JSON body/content-type to satisfy Fastify media-type validation.

## Remaining Checks
1. Frontend build pass completed in container (`docker compose exec frontend npm run build`).
2. Validate inspector UX manually against the door/key flow.
3. Expand parser coverage only within current clean MVP domain.