# Hathor Domain Implementation Map

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 Api
- `apps/hathor/simulation-worker/` - Simulation Worker
- `apps/hathor/svc-veilborn-core/` - Svc Veilborn Core
- `apps/hathor/svc-veilborn-strategy/` - Svc Veilborn Strategy
- `apps/hathor/workbench/` - Workbench
- `apps/hathor/world-api/` - World Api

## Libraries

- `libs/hathor/characters/` - Characters
- `libs/hathor/client/` - Client
- `libs/hathor/database/` - Database
- `libs/hathor/domain-models/` - Domain Models
- `libs/hathor/event-handlers/` - Event Handlers
- `libs/hathor/event-publisher/` - Event Publisher
- `libs/hathor/llm-npc/` - Llm Npc
- `libs/hathor/lore-compiler/` - Lore Compiler
- `libs/hathor/narrative/` - Narrative
- `libs/hathor/pre-production/` - Pre Production
- `libs/hathor/quests/` - Quests
- `libs/hathor/README.md` - README.md
- `libs/hathor/simulation/` - Simulation
- `libs/hathor/sophia-integration/` - Sophia Integration
- `libs/hathor/theory/` - Theory
- `libs/hathor/timeline/` - Timeline
- `libs/hathor/validation/` - Validation
- `libs/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/` - Api
- `docs/domains/hathor/architecture.md` - Architecture.md
- `docs/domains/hathor/database.md` - Database.md
- `docs/domains/hathor/developer-guide.md` - Developer Guide.md
- `docs/domains/hathor/extras/` - Extras
- `docs/domains/hathor/features.md` - Features.md
- `docs/domains/hathor/README.md` - README.md
- `docs/domains/hathor/service-catalog.md` - Service Catalog.md
- `docs/domains/hathor/user-stories.md` - User Stories.md

## Test And Verification Evidence

- `testing/e2e/page-objects/hathor/characters.page.ts`
- `testing/e2e/page-objects/hathor/dashboard.page.ts`
- `testing/e2e/page-objects/hathor/factions.page.ts`
- `testing/e2e/page-objects/hathor/index.ts`
- `testing/e2e/page-objects/hathor/layout.page.ts`
- `testing/e2e/page-objects/hathor/locations.page.ts`
- `testing/e2e/page-objects/hathor/timeline.page.ts`
- `testing/e2e/page-objects/hathor/world-editor.page.ts`
- `testing/e2e/page-objects/hathor/worlds.page.ts`
- `testing/e2e/tests/api/hathor/fixtures.ts`
- `testing/e2e/tests/api/hathor/health.e2e.ts`
- `testing/e2e/tests/api/hathor/index.ts`
- `testing/e2e/tests/api/hathor/merge.e2e.ts`
- `testing/e2e/tests/api/hathor/query.e2e.ts`
- `testing/e2e/tests/api/hathor/versioning.e2e.ts`
- `testing/e2e/tests/api/hathor/worlds.e2e.ts`
- `testing/e2e/tests/hathor/dashboard-worlds.e2e.ts`
- `testing/e2e/tests/hathor/fixtures.ts`
- `testing/e2e/tests/hathor/index.ts`
- `testing/e2e/tests/hathor/navigation-editor.e2e.ts`
- `testing/e2e/tests/hathor/page-object-contracts.e2e.ts`
- `testing/e2e/tests/hathor/world-content.e2e.ts`
- `testing/performance/k6/hathor/README.md`
- `testing/performance/k6/hathor/config.js`
- `testing/performance/k6/hathor/narrative-load.js`
- `testing/performance/k6/hathor/simulation-load.js`
- `testing/performance/k6/hathor/world-load.js`
- `tests/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.js`
- `apps/oshun/admin/.next/server/app/inbox/page.js`
- `apps/oshun/admin/.next/server/app/incidents/page.js`
- `apps/oshun/admin/.next/server/app/policy/page.js`
- `apps/oshun/admin/.next/server/app/review/page.js`
- `apps/oshun/admin/.next/static/chunks/app/inbox/page.js`
- `apps/oshun/admin/.next/static/chunks/app/incidents/page.js`
- `apps/oshun/admin/.next/static/chunks/app/policy/page.js`
- `apps/oshun/admin/.next/static/chunks/app/review/page.js`
- `apps/oshun/admin/src/__tests__/KeyboardTriageReviewSurface.test.tsx`
- `apps/oshun/admin/src/__tests__/ReviewPackageDetail.test.tsx`
- `apps/oshun/admin/src/__tests__/ReviewPackageList.test.tsx`
- `apps/oshun/admin/src/__tests__/admin-review-filtering.test.ts`
- `apps/oshun/admin/src/__tests__/review-detail.test.ts`
- `apps/oshun/admin/src/components/KeyboardTriageReviewSurface.tsx`
- `apps/oshun/admin/src/components/ReviewSavedViewsSurface.tsx`
- `apps/oshun/admin/src/lib/admin-review-filtering.ts`
- `apps/oshun/admin/src/lib/review-detail.ts`
- `apps/oshun/bff/src/__tests__/contract/admin-bff-operations-contract.test.ts`
- `apps/oshun/bff/src/admin/state.ts`
- `apps/oshun/web/.next/server/app/activity/page.js`
- `apps/oshun/web/.next/server/app/domains/[domainId]/page.js`
- `apps/oshun/web/.next/server/app/explore/page.js`
- `apps/oshun/web/.next/server/app/library/page.js`
- `apps/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.
