Files
timmy-home/specs/evennia-implementation-and-training-plan.md
2026-03-28 13:40:14 -04:00

89 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 Timmys long-term mind palace than a fixed roguelike.
NLE/MiniHack remains the benchmark lane.
Evennia becomes the home lane.