# Package/Service to Domain Mapping

Comprehensive mapping of Lilith services and Yemaya packages to their target
Oshun domains.

> **Note**: This mapping was generated during the initial Lilith/Yemaya
> migration. The Oshun platform now includes additional domains: Iris (AI
> assistant), Tara (meditation), Veritas (fact-checking), Psyche (mental
> health), Nyx (astronomy), Aja (motion AI), Aphrodite (live streaming), and
> library-only domains including Aje, Themis, Galatea, Shakti, Nous, Uzume, etc.

Generated: 2026-01-10 | Last updated: 2026-02-14

---

## Target Domains

| Domain         | Responsibility                               | Primary Focus            |
| -------------- | -------------------------------------------- | ------------------------ |
| **Oshun Auth** | Identity, authentication, authorization      | User identity, SSO, RBAC |
| **Lilith**     | Meditation, consciousness, spiritual content | Spiritual experiences    |
| **Yemaya**     | Creative projects, asset management          | Production tools         |
| **Isis**       | Generative AI, GPU jobs, workflows           | AI generation            |
| **Sophia**     | Research, knowledge graphs, citations        | Knowledge & RAG          |
| **Hathor**     | Worldbuilding, narrative, simulations        | Creative worldbuilding   |
| **Bellona**    | Build pipelines, engine bridges, exports     | Infrastructure & DevOps  |

---

## Migration Priority Levels

| Priority | Description                                 | Timeframe   |
| -------- | ------------------------------------------- | ----------- |
| **P1**   | Foundation - Required by all other services | Weeks 1-2   |
| **P2**   | Core Services - Essential domain logic      | Weeks 3-4   |
| **P3**   | Domain Logic - Primary business features    | Weeks 5-8   |
| **P4**   | Enhanced Features - Advanced capabilities   | Weeks 9-12  |
| **P5**   | Advanced & Optional - Specialized features  | Weeks 13-16 |

---

## Lilith Services (81 Total)

### Infrastructure & Core (P1) → Bellona

| Service                 | Description                                 | Key Dependencies  |
| ----------------------- | ------------------------------------------- | ----------------- |
| common                  | Shared utilities for all services           | Standard lib      |
| lib                     | Common library exports                      | Core types        |
| error-handler           | Consistent error handling, offline fallback | Query system      |
| observability           | APM, monitoring, logging infrastructure     | Metrics/tracing   |
| multi-region-resilience | Multi-region failover, SLA management       | HA infrastructure |
| operational-excellence  | DevOps automation, runbooks, SLA tracking   | Infrastructure    |
| sync                    | Cross-device synchronization layer          | Real-time engine  |
| real-time-sync          | Real-time state synchronization             | WebSocket/SSE     |
| offline                 | Offline-first data layer, sync on reconnect | Cache/storage     |

### Authentication & Identity (P2) → Oshun Auth

| Service            | Description                                 | Key Dependencies       |
| ------------------ | ------------------------------------------- | ---------------------- |
| auth               | Primary auth (JWT, OAuth2, MFA, biometric)  | JWT, WebAuthn, OAuth2  |
| auth-orchestrator  | Cross-platform auth flow orchestration      | auth service           |
| consent-management | Consent ledger, voice cloning consent       | auth, user-preferences |
| biometric          | Biometric authentication                    | auth, WebAuthn         |
| token-core         | Token generation and validation             | JWT, auth              |
| token-verification | Token validation and expiry checks          | token-core             |
| token-access       | Token-based access control                  | token-core             |
| user-preferences   | User profile, locale, timezone, preferences | auth, database         |
| anonymization      | Privacy-preserving data pipelines           | auth, database         |
| data-governance    | GDPR/CCPA compliance, data rights           | database, compliance   |

### Meditation & Consciousness (P3) → Lilith

| Service               | Description                               | Key Dependencies             |
| --------------------- | ----------------------------------------- | ---------------------------- |
| meditation-core       | Shared meditation logic, mode selection   | Safety helpers               |
| meditation-generation | Generate personalized meditations         | AI, TTS, RAG                 |
| meditation-experience | Meditation playback, progression tracking | meditation-core, media       |
| group-meditation      | Synchronized group sessions               | Real-time-sync, conversation |
| yoga-practice         | Yoga teaching, pose tracking              | media, conversation          |
| spiritual-embeddings  | Spiritual content embeddings              | vectordb, ingestion          |
| spiritual-guidance    | AI spiritual mentor guidance system       | AI, RAG                      |
| daily-content         | Daily meditation delivery, scheduling     | content, media               |
| teacher-blessing      | Blessings as transferable NFT assets      | NFT (blockchain)             |
| curricula             | Structured learning paths, courses        | content, rag                 |
| progress-sync         | Meditation progress across devices        | user-preferences, sync       |
| tiered-subscription   | Subscription tiers for content access     | payment-orchestrator         |

### Content & Media (P3) → Lilith

| Service           | Description                                  | Key Dependencies          |
| ----------------- | -------------------------------------------- | ------------------------- |
| content           | Course, lesson, meditation catalog           | database, versioning      |
| media             | Media metadata, signed URLs, packaging       | S3, FFmpeg, HLS           |
| tts               | Text-to-speech synthesis                     | GPU, Chatterbox, SSML     |
| stt               | Speech-to-text transcription                 | Whisper, audio            |
| voice-pipeline    | Voice I/O pipeline orchestration             | TTS, STT, audio           |
| audio-handoff     | Cross-device audio continuity                | media, sync               |
| webrtc            | WebRTC real-time voice chat                  | SFU, audio                |
| conversation      | Chat threads, SSE streaming                  | AI, TTS/STT, RAG          |
| notes             | User notes, journaling                       | database, conversation    |
| review            | Content review workflows                     | AI, moderation            |
| moderation        | Content filtering, toxicity detection        | AI, content               |
| safety-automation | Automated safety checks, jailbreak detection | moderation, AI            |
| notification      | Multi-channel notifications                  | Push/Email, message queue |

### Knowledge & Research (P3) → Sophia

| Service               | Description                              | Key Dependencies    |
| --------------------- | ---------------------------------------- | ------------------- |
| knowledge             | Knowledge graph, ontology management     | vectordb, ingestion |
| rag                   | Retrieval-augmented generation           | knowledge, vectordb |
| vectordb              | Embedding storage and semantic search    | database            |
| ingestion             | Content pipeline, OCR, document parsing  | vectordb, knowledge |
| content-licensing     | License management, attribution tracking | content, database   |
| content-verification  | Fact-checking, source verification       | content, RAG        |
| rights-management     | Creator rights, licensing enforcement    | blockchain, content |
| community-translation | Translation workflows with review        | content, review     |
| language-detection    | Auto-detect content language             | NLP                 |
| indexer               | Document indexing and search             | knowledge, vectordb |
| curator-admin         | Knowledge graph curation UI/API          | knowledge, rag      |
| knowledge-access      | Access control for knowledge base        | knowledge, RBAC     |

### AI & Generative (P4) → Isis

| Service            | Description                              | Key Dependencies   |
| ------------------ | ---------------------------------------- | ------------------ |
| ai                 | LLM orchestration, multi-agent system    | LLM providers, RAG |
| comfyui            | ComfyUI integration for image generation | GPU jobs           |
| generative-fractal | Procedural 3D generation                 | AI, 3D generation  |

### Blockchain & Economy (P5) → Yemaya

| Service              | Description                            | Key Dependencies         |
| -------------------- | -------------------------------------- | ------------------------ |
| blockchain           | Web3 integration, NFT/token operations | Web3, ethers             |
| payment-orchestrator | Payment routing and orchestration      | blockchain, Stripe       |
| micro-transaction    | Small value transactions               | payment-orchestrator     |
| native-token         | $LILITH token management               | blockchain               |
| staking-mechanism    | Staking rewards, yield                 | blockchain, native-token |
| transaction-core     | Transaction recording, settlement      | blockchain, database     |
| transaction-manager  | Transaction lifecycle management       | transaction-core         |
| settlement           | Settlement processing, finality        | transaction-manager      |
| creator-royalty      | Creator royalty distributions          | blockchain, rights       |
| cross-chain-bridge   | Multi-chain token bridging             | blockchain, native-token |
| fiat-ramp            | Fiat to crypto conversion              | payment-orchestrator     |
| defi-integration     | DeFi protocols (staking, AMM)          | blockchain               |
| dao-governance       | DAO voting, governance contracts       | blockchain, voting       |

### Metaverse & Worldbuilding (P5) → Hathor

| Service         | Description                       | Key Dependencies     |
| --------------- | --------------------------------- | -------------------- |
| metaverse       | 3D world engine, realm management | Three.js, physics    |
| avatar-cosmetic | Avatar customization, cosmetics   | metaverse, media     |
| catalog         | Asset catalog, metadata           | database, versioning |

### BFF & API Layer (P2) → Bellona

| Service     | Description                     | Key Dependencies  |
| ----------- | ------------------------------- | ----------------- |
| bff         | Backend-for-Frontend aggregator | All core services |
| partner-api | Third-party API gateway         | BFF, auth         |

### Miscellaneous (P5)

| Service           | Target Domain | Description                   |
| ----------------- | ------------- | ----------------------------- |
| ipfs-integration  | Yemaya        | Decentralized storage gateway |
| veilborn-core     | Lilith        | Veilborn feature library      |
| veilborn-strategy | Lilith        | Veilborn strategy engine      |

---

## Lilith Packages (15 Total)

### Infrastructure Packages (P1) → Bellona

| Package                | Description                            | Key Dependencies |
| ---------------------- | -------------------------------------- | ---------------- |
| core                   | Core types, utilities, constants       | zod              |
| database               | Database utilities, connection pooling | knex, pg         |
| errors                 | Error definitions and schemas          | Standard library |
| cache                  | Caching layer utilities                | redis            |
| queue                  | Job queue utilities                    | Bull/BullMQ      |
| logger                 | Structured logging                     | winston/pino     |
| metrics                | Metrics collection                     | Prometheus       |
| tracing                | Distributed tracing                    | OpenTelemetry    |
| testing                | Testing utilities                      | vitest           |
| fastify-core           | HTTP server base class                 | Fastify          |
| config                 | Configuration management               | dotenv           |
| tsconfig-lilith        | Shared TypeScript config               | TypeScript       |
| eslint-config-lilith   | Shared linting rules                   | ESLint           |
| prettier-config-lilith | Shared formatting config               | Prettier         |

### Domain Packages

| Package  | Target Domain | Description                    |
| -------- | ------------- | ------------------------------ |
| vectordb | Sophia        | Vector database client library |

---

## Yemaya Packages (50+ Total)

### Infrastructure Packages (P1) → Bellona

| Package        | Description                       | Key Dependencies   |
| -------------- | --------------------------------- | ------------------ |
| types          | Shared type definitions           | TypeScript         |
| core           | Platform utilities and validation | Utilities          |
| database       | Database ORM and migrations       | Prisma, PostgreSQL |
| infrastructure | Cloud infrastructure utilities    | Cloud SDKs         |
| logging        | Structured logging                | winston/pino       |
| rate-limit     | Rate limiting utilities           | redis              |
| websocket      | WebSocket utilities               | ws                 |
| activity       | Activity logging                  | database, events   |
| health         | Service health monitoring         | health checks      |
| proto          | Protocol buffer definitions       | Protobuf           |

### Auth & Users (P2) → Oshun Auth

| Package       | Description               | Key Dependencies |
| ------------- | ------------------------- | ---------------- |
| auth          | Authentication utilities  | JWT, OAuth       |
| rbac          | Role-based access control | auth             |
| users         | User management           | auth, database   |
| organizations | Organization management   | users, database  |

### AI & Intelligence (P4) → Isis

| Package              | Description                                | Key Dependencies          |
| -------------------- | ------------------------------------------ | ------------------------- |
| ai                   | LLM client providers                       | Anthropic, OpenAI, Google |
| ai-advanced          | Advanced AI patterns (reasoning, planning) | ai                        |
| ai-model-marketplace | Model registry and routing                 | ai, database              |
| ai-video             | AI video generation and editing            | GPU jobs                  |
| agents               | Multi-agent orchestration                  | ai, LangGraph             |
| gpu-jobs             | GPU compute job dispatching                | AWS, Bull, Redis          |
| autonomous-pipelines | Automated workflow orchestration           | gpu-jobs, agents          |

### 3D & Rendering (P4-P5) → Yemaya/Hathor

| Package            | Target Domain | Description                      |
| ------------------ | ------------- | -------------------------------- |
| 3d-generation      | Yemaya        | AI-powered 3D generation         |
| gaussian-splatting | Yemaya        | NeRF and 3D Gaussian Splatting   |
| blender            | Hathor        | Blender automation via WebSocket |
| godot              | Hathor        | Godot GDExtension bridge         |
| unreal             | Hathor        | Unreal Engine integration        |
| unity              | Hathor        | Unity game engine integration    |
| virtual-production | Hathor        | LED wall, camera tracking        |
| openusd            | Yemaya        | OpenUSD format support           |
| houdini            | Hathor        | Houdini integration              |

### Media Processing (P4) → Yemaya/Lilith

| Package | Target Domain | Description                    |
| ------- | ------------- | ------------------------------ |
| assets  | Yemaya        | Digital asset management       |
| audio   | Lilith        | Audio processing and synthesis |
| video   | Yemaya        | Video processing and encoding  |

### Creative Tools (P4) → Hathor

| Package        | Description                      | Key Dependencies      |
| -------------- | -------------------------------- | --------------------- |
| pre-production | Scriptwriting, storyboarding     | agents, video         |
| mocap          | Motion capture data processing   | motion capture        |
| metahuman      | Digital human creation           | 3D generation, unreal |
| davinci        | DaVinci-like advanced generation | AI, creative          |

### Game & Interaction (P5) → Hathor

| Package          | Description                    | Key Dependencies |
| ---------------- | ------------------------------ | ---------------- |
| gameplay-systems | Game mechanics, systems design | game logic       |
| quest-dialogue   | Quest and dialogue systems     | dialogue graphs  |
| llm-npc          | AI NPC conversations           | ai, agents       |
| xr               | VR/AR/MR platform support      | WebXR API        |

### Community & Collaboration (P5)

| Package       | Target Domain | Description                     |
| ------------- | ------------- | ------------------------------- |
| collaboration | Hathor        | Real-time collaborative editing |
| community     | Lilith        | Community features, forums      |

### Knowledge & Research (P4) → Sophia

| Package           | Description                       | Key Dependencies    |
| ----------------- | --------------------------------- | ------------------- |
| cultural-research | Cultural context and research     | knowledge, research |
| theory            | Theoretical frameworks and models | Knowledge, research |

### SDKs (P4) → Bellona

| Package        | Description    | Key Dependencies |
| -------------- | -------------- | ---------------- |
| sdk            | SDK for APIs   | API bindings     |
| sdk-cpp        | C++ SDK        | C++ bindings     |
| sdk-python     | Python SDK     | Python bindings  |
| sdk-typescript | TypeScript SDK | TypeScript       |

### Safety & Moderation (P3) → Lilith

| Package | Description              | Key Dependencies      |
| ------- | ------------------------ | --------------------- |
| safety  | Content safety utilities | moderation, filtering |

### Enterprise (P5) → Bellona

| Package             | Description              | Key Dependencies |
| ------------------- | ------------------------ | ---------------- |
| enterprise-features | Enterprise tier features | Multi-tenancy    |

### Marketplace (P5) → Yemaya

| Package            | Description         | Key Dependencies |
| ------------------ | ------------------- | ---------------- |
| asset-marketplace  | Asset distribution  | database, assets |
| plugin-marketplace | Plugin distribution | database, assets |

### UI (P4) → Hathor

| Package | Description          | Key Dependencies |
| ------- | -------------------- | ---------------- |
| ui      | UI component library | React, Radix UI  |

---

## Domain Summary

### Bellona (Infrastructure)

- **Lilith Services:** 9 infrastructure services
- **Lilith Packages:** 14 infrastructure packages
- **Yemaya Packages:** 10 infrastructure packages
- **Total:** 33 components

### Oshun Auth (Identity)

- **Lilith Services:** 10 auth services
- **Yemaya Packages:** 4 auth packages
- **Total:** 14 components

### Lilith (Consciousness)

- **Lilith Services:** 30 meditation/content services
- **Yemaya Packages:** 3 related packages
- **Total:** 33 components

### Sophia (Knowledge)

- **Lilith Services:** 13 knowledge services
- **Yemaya Packages:** 2 research packages
- **Total:** 15 components

### Isis (AI Generation)

- **Lilith Services:** 3 AI services
- **Yemaya Packages:** 7 AI packages
- **Total:** 10 components

### Yemaya (Creative)

- **Lilith Services:** 13 blockchain/economy services
- **Yemaya Packages:** 6 asset/creative packages
- **Total:** 19 components

### Hathor (Worldbuilding)

- **Lilith Services:** 3 metaverse services
- **Yemaya Packages:** 15 creative/game packages
- **Total:** 18 components

---

## Critical Path Dependencies

```
┌─────────────────────────────────────────────────────────────┐
│                     BELLONA (P1)                            │
│  Infrastructure: core, database, cache, queue, logging      │
│  DevOps: observability, metrics, tracing, config            │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    OSHUN AUTH (P2)                          │
│  Identity: auth, sessions, tokens, OAuth, MFA, RBAC         │
│  Consent: data governance, privacy, anonymization           │
└─────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│   SOPHIA (P3) │    │  LILITH (P3)  │    │   ISIS (P4)   │
│   Knowledge   │    │  Meditation   │    │  AI/Generate  │
│   RAG/Vector  │    │  Content      │    │  GPU Jobs     │
└───────────────┘    └───────────────┘    └───────────────┘
        │                     │                     │
        └─────────────────────┼─────────────────────┘
                              ▼
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│  YEMAYA (P4)  │    │  HATHOR (P5)  │    │ BELLONA (P2)  │
│  Creative     │    │  Worldbuild   │    │  BFF/API      │
│  Assets       │    │  Metaverse    │    │  Integration  │
└───────────────┘    └───────────────┘    └───────────────┘
```

---

## Migration Phases

### Phase 1: Foundation (Weeks 1-2)

1. Set up Nx workspace structure
2. Migrate Bellona infrastructure packages
3. Configure shared tooling (TypeScript, ESLint, Prettier)
4. Set up CI/CD pipelines

### Phase 2: Core Services (Weeks 3-4)

1. Migrate Oshun Auth services
2. Set up BFF and API gateway
3. Configure observability and monitoring
4. Establish cross-service communication

### Phase 3: Domain Logic (Weeks 5-8)

1. Migrate Lilith meditation services
2. Migrate Sophia knowledge services
3. Set up moderation and safety systems
4. Configure content delivery

### Phase 4: Enhanced Features (Weeks 9-12)

1. Migrate Isis AI services
2. Set up GPU job infrastructure
3. Migrate Yemaya blockchain services
4. Configure payment processing

### Phase 5: Advanced Features (Weeks 13-16)

1. Migrate Hathor worldbuilding services
2. Set up metaverse infrastructure
3. Configure game engine bridges
4. Complete marketplace features

---

## Revision History

| Version | Date       | Author           | Changes         |
| ------- | ---------- | ---------------- | --------------- |
| 1.0     | 2026-01-10 | Development Team | Initial version |