# Evennia Implementation and Training Plan

Goal:
Make Timmy inhabitable in a local persistent Evennia world through the Hermes harness, while preserving the best training methodology from day one.

Core doctrine:
- Hermes is the brain.
- Evennia is the persistent world body.
- World continuity should live in Evennia objects, rooms, exits, scripts, and database state.
- Timmy should not need to spend prompt context re-establishing his home every session.
- World interaction must still flow through Hermes so it becomes training data.

## Lane split

1. World lane
- stand up local Evennia
- create first room graph
- create first object set
- expose a watchable operator surface
- make Timmy able to inhabit and act in the world

2. Training lane
- keep Hermes in the loop for all meaningful Timmy actions
- emit structured Evennia event logs
- align world events with Hermes session IDs
- support replay and eval for world basics
- keep this lane complementary to NLE/MiniHack benchmark work

## First implementation milestone

World path:
- local Evennia project under `~/.timmy/evennia/`

First canonical rooms:
- Gate
- Courtyard
- Workshop
- Archive
- Chapel

First persistent objects:
- Book of the Soul
- Workbench
- Map Table
- Prayer Wall
- Memory Shelves
- Mirror of Sessions

First operator surface:
- browser client on localhost:4001 and/or telnet client on localhost:4000

First Timmy control surface:
- Hermes -> Evennia adapter, ideally via MCP
- Timmy can: connect, look, move, inspect, read, and revisit persistent state

## Training methodology requirements

1. Hermes-in-the-loop
- no hidden autonomous world bot as the canonical path
- Timmy acts through Hermes sessions so transcripts land in `~/.hermes*/sessions/`

2. Structured world telemetry
- write Evennia world events to `~/.timmy/training-data/evennia/`
- capture actor, room, object, command, result, timestamp, and any persistent state changes

3. Session/event alignment
- every world interaction trace should be linkable to a Hermes session ID
- this keeps DPO/export work honest

4. Replayability
- define one basic replay harness for world fundamentals
- minimum replay path: connect -> look -> move -> inspect -> read

5. Eval set
- orientation
- navigation
- object inspection
- persistence recall
- simple task completion

## Why this matters

Evennia is not just another game to scrape.
It is a local durable world substrate.
That makes it a much better candidate for Timmy’s long-term mind palace than a fixed roguelike.

NLE/MiniHack remains the benchmark lane.
Evennia becomes the home lane.
