Generated on May 8, 2026. This document maps the current repository footprint and Oshun-specific integration points for Hathor.
Implementation Context#
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.
Status Snapshot#
- Repository status: Repository implementation exists under apps/libs/services.
- Oshun integration status: Referenced in Oshun apps, libraries, or docs.
- TODO phases:
7
Applications#
apps/hathor/narrative-api/- Narrative Apiapps/hathor/simulation-worker/- Simulation Workerapps/hathor/svc-veilborn-core/- Svc Veilborn Coreapps/hathor/svc-veilborn-strategy/- Svc Veilborn Strategyapps/hathor/workbench/- Workbenchapps/hathor/world-api/- World Api
Libraries#
libs/hathor/characters/- Characterslibs/hathor/client/- Clientlibs/hathor/database/- Databaselibs/hathor/domain-models/- Domain Modelslibs/hathor/event-handlers/- Event Handlerslibs/hathor/event-publisher/- Event Publisherlibs/hathor/llm-npc/- Llm Npclibs/hathor/lore-compiler/- Lore Compilerlibs/hathor/narrative/- Narrativelibs/hathor/pre-production/- Pre Productionlibs/hathor/quests/- Questslibs/hathor/README.md- README.mdlibs/hathor/simulation/- Simulationlibs/hathor/sophia-integration/- Sophia Integrationlibs/hathor/theory/- Theorylibs/hathor/timeline/- Timelinelibs/hathor/validation/- Validationlibs/hathor/world/- World
Services#
No repository entries discovered.
OpenAPI And Contract Roots#
No OpenAPI or domain-specific API root discovered.
Existing Standalone Domain Docs#
docs/domains/hathor/api/- Apidocs/domains/hathor/architecture.md- Architecture.mddocs/domains/hathor/database.md- Database.mddocs/domains/hathor/developer-guide.md- Developer Guide.mddocs/domains/hathor/extras/- Extrasdocs/domains/hathor/features.md- Features.mddocs/domains/hathor/README.md- README.mddocs/domains/hathor/service-catalog.md- Service Catalog.mddocs/domains/hathor/user-stories.md- User Stories.md
Test And Verification Evidence#
testing/e2e/page-objects/hathor/characters.page.tstesting/e2e/page-objects/hathor/dashboard.page.tstesting/e2e/page-objects/hathor/factions.page.tstesting/e2e/page-objects/hathor/index.tstesting/e2e/page-objects/hathor/layout.page.tstesting/e2e/page-objects/hathor/locations.page.tstesting/e2e/page-objects/hathor/timeline.page.tstesting/e2e/page-objects/hathor/world-editor.page.tstesting/e2e/page-objects/hathor/worlds.page.tstesting/e2e/tests/api/hathor/fixtures.tstesting/e2e/tests/api/hathor/health.e2e.tstesting/e2e/tests/api/hathor/index.tstesting/e2e/tests/api/hathor/merge.e2e.tstesting/e2e/tests/api/hathor/query.e2e.tstesting/e2e/tests/api/hathor/versioning.e2e.tstesting/e2e/tests/api/hathor/worlds.e2e.tstesting/e2e/tests/hathor/dashboard-worlds.e2e.tstesting/e2e/tests/hathor/fixtures.tstesting/e2e/tests/hathor/index.tstesting/e2e/tests/hathor/navigation-editor.e2e.tstesting/e2e/tests/hathor/page-object-contracts.e2e.tstesting/e2e/tests/hathor/world-content.e2e.tstesting/performance/k6/hathor/README.mdtesting/performance/k6/hathor/config.jstesting/performance/k6/hathor/narrative-load.jstesting/performance/k6/hathor/simulation-load.jstesting/performance/k6/hathor/world-load.jstests/integration/flows/sophia-hathor.integration.test.ts
Oshun Integration Summary#
| Reference Scope | Count |
|---|---|
| apps/oshun | 2098 |
| libs/oshun | 2 |
Oshun-Specific Integration References#
apps/oshun/admin/.next/server/app/api/admin/workspaces/[workspaceId]/saved-views/route.jsapps/oshun/admin/.next/server/app/inbox/page.jsapps/oshun/admin/.next/server/app/incidents/page.jsapps/oshun/admin/.next/server/app/policy/page.jsapps/oshun/admin/.next/server/app/review/page.jsapps/oshun/admin/.next/static/chunks/app/inbox/page.jsapps/oshun/admin/.next/static/chunks/app/incidents/page.jsapps/oshun/admin/.next/static/chunks/app/policy/page.jsapps/oshun/admin/.next/static/chunks/app/review/page.jsapps/oshun/admin/src/__tests__/KeyboardTriageReviewSurface.test.tsxapps/oshun/admin/src/__tests__/ReviewPackageDetail.test.tsxapps/oshun/admin/src/__tests__/ReviewPackageList.test.tsxapps/oshun/admin/src/__tests__/admin-review-filtering.test.tsapps/oshun/admin/src/__tests__/review-detail.test.tsapps/oshun/admin/src/components/KeyboardTriageReviewSurface.tsxapps/oshun/admin/src/components/ReviewSavedViewsSurface.tsxapps/oshun/admin/src/lib/admin-review-filtering.tsapps/oshun/admin/src/lib/review-detail.tsapps/oshun/bff/src/__tests__/contract/admin-bff-operations-contract.test.tsapps/oshun/bff/src/admin/state.tsapps/oshun/web/.next/server/app/activity/page.jsapps/oshun/web/.next/server/app/domains/[domainId]/page.jsapps/oshun/web/.next/server/app/explore/page.jsapps/oshun/web/.next/server/app/library/page.jsapps/oshun/web/.next/server/app/page.js
Additional references omitted: 2075
Documentation Gaps#
- Repository implementation roots are present and reflected above.
- Standalone domain docs exist and were folded into the evidence profile.
- Domain test evidence exists and is listed above.