Eve library

Hathor Domain Feature Inventory

Guide

Revision 1

On this page

Generated on May 8, 2026. This document captures domain feature scope from the Oshun repository and the phase checklist in TODOS.md.

Overview#

Hathor is the creative heart of the Oshun ecosystem for anyone who builds fictional worlds. It provides everything needed to design, populate, simulate, validate, and export interactive worlds -- from the geography and climate of a fantasy continent, through its economies, politics, and cultures, all the way to the quests, dialogues, and AI-driven NPCs that bring the world to life.

Coverage Summary#

  • Domain slug: hathor
  • TODO phase coverage: 7
  • Checklist-derived feature items: 90
  • Repository status: Repository implementation exists under apps/libs/services.
  • Oshun integration status: Referenced in Oshun apps, libraries, or docs.
  • Source confidence: Implementation-backed and documentation-backed

Source Hierarchy#

  1. Actual implementation footprints in apps/, libs/, services/, and openapi/
  2. TODO-derived capability scope from the mapped phase sections
  3. Existing standalone domain docs in docs/domains/hathor/

Capability Pillars#

Capability Pillar Primary Source Status
Executive Summary docs/domains/hathor/features.md implementation-backed
World Modeling docs/domains/hathor/features.md implementation-backed
Narrative Design docs/domains/hathor/features.md implementation-backed
World Simulation docs/domains/hathor/features.md implementation-backed
LLM-Powered NPC Intelligence docs/domains/hathor/features.md implementation-backed
Lore Validation docs/domains/hathor/features.md implementation-backed
Lore Compilation docs/domains/hathor/features.md implementation-backed
Game Design Theory docs/domains/hathor/features.md implementation-backed
Pre-Production Tools docs/domains/hathor/features.md implementation-backed
Version Control for Worlds docs/domains/hathor/features.md implementation-backed
Research Grounding (Sophia Integration) docs/domains/hathor/features.md implementation-backed
Visual Workbench (Web Application) docs/domains/hathor/features.md implementation-backed
TypeScript SDK docs/domains/hathor/features.md implementation-backed
Cross-Domain Integration docs/domains/hathor/features.md implementation-backed
Platform Availability docs/domains/hathor/features.md implementation-backed
Feature Comparison: Simulation Engines docs/domains/hathor/features.md implementation-backed
Feature Comparison: NPC AI Platforms docs/domains/hathor/features.md implementation-backed
Feature Comparison: Lore Compilation Targets docs/domains/hathor/features.md implementation-backed

Implementation-Derived Capability Surfaces#

Category Path Inferred Capability Surface
Application apps/hathor/narrative-api/ Narrative Api
Application apps/hathor/simulation-worker/ Simulation Worker
Application apps/hathor/svc-veilborn-core/ Svc Veilborn Core
Application apps/hathor/svc-veilborn-strategy/ Svc Veilborn Strategy
Application apps/hathor/workbench/ Workbench
Application apps/hathor/world-api/ World Api
Library libs/hathor/characters/ Characters
Library libs/hathor/client/ Client
Library libs/hathor/database/ Database
Library libs/hathor/domain-models/ Domain Models
Library libs/hathor/event-handlers/ Event Handlers
Library libs/hathor/event-publisher/ Event Publisher
Library libs/hathor/llm-npc/ Llm Npc
Library libs/hathor/lore-compiler/ Lore Compiler
Library libs/hathor/narrative/ Narrative
Library libs/hathor/pre-production/ Pre Production
Library libs/hathor/quests/ Quests
Library libs/hathor/README.md README.md
Library libs/hathor/simulation/ Simulation
Library libs/hathor/sophia-integration/ Sophia Integration
Library libs/hathor/theory/ Theory
Library libs/hathor/timeline/ Timeline
Library libs/hathor/validation/ Validation
Library libs/hathor/world/ World

Canonical Standalone Feature Coverage#

Heading Level Feature Family
H2 Executive Summary
H2 World Modeling
H3 World Configuration
H3 Geography
H3 Factions
H3 Economy
H3 Legal Systems
H3 Culture
H3 Characters
H3 Locations
H3 Timelines
H2 Narrative Design
H3 Quest System
H3 Dialogue System
H3 Story Graph
H3 Journal and Codex System
H3 Narrative Export
H2 World Simulation
H3 Economy Simulation
H3 Politics Simulation
H3 Culture Evolution Simulation
H3 Scenario Generation
H3 NPC Behavior Trees
H3 Physics Engine
H3 State Persistence
H2 LLM-Powered NPC Intelligence
H3 Personality System
H3 Emotional State
H3 Memory System
H3 World Awareness
H3 Dialogue Generation
H3 Safety and Guardrails
H3 Behavior Control
H3 NPC-to-NPC Conversations
H3 Platform Integration
H3 Provider Chain
H2 Lore Validation
H3 Timeline Validation
H3 Causality Validation
H3 Taxonomy Validation
H3 Contradiction Detection
H3 Unified Validation
H2 Lore Compilation
H3 Game Engine Compilation
H3 Screenplay Compilation
H3 Bellona Package Builder
H2 Game Design Theory
H3 MDA Framework
H3 Narrative Theory
H3 Cinematography Planning
H2 Pre-Production Tools
H3 Chronicle Parser
H3 Narrative Structure Analysis
H3 Visual Storyboarding
H3 Project Management
H2 Version Control for Worlds
H3 Git-Like Versioning
H3 Entity Management Within Versions
H2 Research Grounding (Sophia Integration)
H3 Citation Service
H3 Research Grounding Service
H3 Lore Fact-Checking
H2 Visual Workbench (Web Application)
H3 Dashboard
H3 Worlds Page
H3 World Editor
H3 Characters Page
H3 Factions Page
H3 Locations Page
H3 Timeline Page
H2 TypeScript SDK
H3 World Resource
H3 Narrative Resource
H3 Simulation Resource
H3 Helper Functions
H3 Quest Templates
H3 Error Handling
H2 Cross-Domain Integration
H3 Events Published by Hathor
H3 Events Consumed by Hathor
H3 Connected Domains
H2 Platform Availability
H2 Feature Comparison: Simulation Engines
H2 Feature Comparison: NPC AI Platforms
H2 Feature Comparison: Lore Compilation Targets

Detailed TODO Phase Coverage#

Phase 7: Hathor (Worldbuilding & Narrative) Migration#

  • Checklist items captured: 90
  • Source: TODOS.md

7.1 Hathor Library: Domain Models#

  • 7.1.1 Create libs/hathor/domain-models/ project
  • 7.1.2 Add project.json with scope:hathor, layer:domain tags
  • 7.1.3 Define Faction model
  • 7.1.4 Define Economy model
  • 7.1.5 Define Law model
  • 7.1.6 Define Culture model
  • 7.1.7 Define Geography model
  • 7.1.8 Define Timeline model
  • 7.1.9 Define Character model
  • 7.1.10 Define Location model
  • 7.1.11 Ensure models are engine-agnostic (no engine SDK types)

7.2 Hathor Library: Narrative Systems#

  • 7.2.1 Create libs/hathor/narrative/ project
  • 7.2.2 Add project.json with scope:hathor, layer:domain tags
  • 7.2.3 Migrate yemaya/packages/quest-dialogue
  • 7.2.4 Create Story Graph data structure
  • 7.2.5 Create Quest model and builder
  • 7.2.6 Create Dialogue Tree model
  • 7.2.7 Create Journal/Codex system
  • 7.2.8 Add narrative branching utilities

7.3 Hathor Library: Theory (Story/Cinematography)#

  • 7.3.1 Create libs/hathor/theory/ project
  • 7.3.2 Add project.json with scope:hathor, layer:domain tags
  • 7.3.3 Migrate story-related parts of yemaya/packages/theory
  • 7.3.4 Create MDA framework implementation
  • 7.3.5 Create story structure templates (hero's journey, etc.)
  • 7.3.6 Add visual composition rules

7.4 Hathor Library: Simulation ✅#

  • 7.4.1 Create libs/hathor/simulation/ project
  • 7.4.2 Add project.json with scope:hathor, layer:domain tags
  • 7.4.3 Create economy simulation engine
  • 7.4.4 Create politics simulation engine
  • 7.4.5 Create culture evolution simulation
  • 7.4.6 Create scenario generator

7.5 Hathor Library: Lore Compiler#

  • 7.5.1 Create libs/hathor/lore-compiler/ project
  • 7.5.2 Add project.json with scope:hathor, layer:domain tags
  • 7.5.3 Create engine-ready artifact generator (quests)
  • 7.5.4 Create film-ready artifact generator (script beats, scene cards)
  • 7.5.5 Create interchange format for Bellona

7.6 Hathor Library: Validation ✅#

  • 7.6.1 Create libs/hathor/validation/ project
  • 7.6.2 Add project.json with scope:hathor, layer:domain tags
  • 7.6.3 Create timeline consistency checker
  • 7.6.4 Create causality validator
  • 7.6.5 Create taxonomy validator
  • 7.6.6 Add lore contradiction detector

7.7 Hathor Library: Pre-Production ✅#

  • 7.7.1 Create libs/hathor/pre-production/ project
  • 7.7.2 Add project.json with scope:hathor, layer:domain tags
  • 7.7.3 Migrate yemaya/packages/pre-production
  • 7.7.4 Create scriptwriting tools
  • 7.7.5 Create storyboarding tools
  • 7.7.6 Create planning utilities

7.8 Hathor App: World Model API#

  • 7.8.1 Create apps/hathor/world-api/ project
  • 7.8.2 Add project.json with scope:hathor, type:app tags
  • 7.8.3 Create world state CRUD endpoints
  • 7.8.4 Create versioning endpoints
  • 7.8.5 Create world query endpoints
  • 7.8.6 Add diff/merge utilities for collaborative editing

7.9 Hathor App: Narrative API ✅#

  • 7.9.1 Create apps/hathor/narrative-api/ project
  • 7.9.2 Add project.json with scope:hathor, type:app tags
  • 7.9.3 Create story graph endpoints
  • 7.9.4 Create quest CRUD endpoints
  • 7.9.5 Create dialogue tree endpoints
  • 7.9.6 Add constraint validation endpoints

7.10 Hathor App: Simulation Workers ✅#

  • 7.10.1 Create apps/hathor/simulation-worker/ project
  • 7.10.2 Add project.json with scope:hathor, type:app tags
  • 7.10.3 Create economy simulation worker
  • 7.10.4 Create politics simulation worker
  • 7.10.5 Create culture simulation worker
  • 7.10.6 Create scenario generation worker

7.11 Hathor App: Worldbuilding Workbench ✅#

  • 7.11.1 Create apps/hathor/workbench/ project
  • 7.11.2 Add project.json with scope:hathor, type:app tags
  • 7.11.3 Create world editor UI
  • 7.11.4 Create timeline visualization
  • 7.11.5 Create faction relationship graph UI

7.12 Hathor Client SDK#

  • 7.12.1 Create libs/hathor/client/ project
  • 7.12.2 Add project.json with scope:hathor, layer:clients tags
  • 7.12.3 Generate TypeScript client from OpenAPI
  • 7.12.4 Create @oshun/hathor-client package
  • 7.12.5 Add world state helpers
  • 7.12.6 Add quest generation helpers
  • 7.12.7 Add lore validation helpers

7.13 Hathor Database Schema#

  • 7.13.1 Create libs/hathor/database/ project
  • 7.13.2 Add project.json with scope:hathor, layer:data tags
  • 7.13.3 Define Prisma schema for Hathor:
    • World model
    • WorldVersion model
    • Faction model
    • Character model
    • Location model
    • Timeline model
    • Quest model
    • DialogueTree model
    • SimulationRun model
  • 7.13.4 Create migrations (local dev environment setup completed)
  • 7.13.5 Add seed data

7.14 Integration with Sophia#

  • 7.14.1 Create Hathor → Sophia citation integration
  • 7.14.2 Add research grounding for world facts
  • 7.14.3 Create lore fact-checking against research

7.15 Migration from Lilith#

  • 7.15.1 Audit lilith/services/veilborn-core for Hathor migration
  • 7.15.2 Audit lilith/services/veilborn-strategy for Hathor migration
  • 7.15.3 Plan migration of Veilborn Chronicles to Hathor
  • 7.15.4 Create migration scripts for existing world data