Eve library

Oshun Domain Documentation Coverage

Guide

Revision 1

On this page

This directory is the canonical domain documentation set for the Oshun monorepo. Oshun is organized as a set of domains — bounded contexts, each named after a deity, that each own a coherent slice of the product (for example, isis owns generative media, lilith owns the contemplative wellness platform, and shared owns cross-cutting platform infrastructure). A domain is the unit of ownership: it decides what code lives inside it, what contracts it exposes to other domains, and what it deliberately does not do.

Every domain directory contains the same three documents, so a reader who learns the layout once can navigate any domain:

  • architecture.md — ownership boundaries, runtime shape, data ownership, and integration topology. Read this first to understand how the domain is built and where it sits relative to its neighbours.
  • features.md — current and planned capabilities, organized by domain responsibility. Read this to understand what the domain does for users.
  • specifications.md — API, data model, contract, validation, testing, and operational requirements. Read this for the precise, code-grounded contract: every schema, enum, endpoint, and event traces to a real source file.

The root roadmap in TODOS/ remains the atomic implementation checklist. The docs in DOMAINS/ capture domain ownership, package surface, cross-domain contracts, and planned capability envelopes so every roadmap item has a clear home without duplicating all task-level checkboxes.

Each markdown document also has a generated HTML reader alongside it (architecture.html, features.html, specifications.html), and DOMAINS/index.html is a hub linking all of them. The HTML readers provide a collapsible navigation sidebar, search, and cross-document tabs; regenerate them with python3 tools/render-domain-docs.py after editing any markdown source.

Coverage Summary#

The figures below confirm that every domain — implemented or still planned — has a complete, consistent documentation set.

  • Domain directories present: 54.
  • Required docs present for every domain: architecture.md, features.md, and specifications.md.
  • Named implementation domains under apps/*, libs/*, and services/* are represented here.
  • Named planned domains from TODOS/index.md are represented here, including planned-only domains with no workspace packages yet.
  • Cross-cutting roadmap phases are assigned to the owning domain docs below rather than modeled as separate product domains.

Domain Inventory#

Domain Status Canonical code locations Roadmap coverage
Aglaea Implemented library domain libs/aglaea/* Phase 34
Airmid Implemented library domain libs/airmid/* Phase 35
Aja Implemented app/library domain apps/aja/*, libs/aja/* Phase 16, Phase 84
Aje Implemented library domain libs/aje/* Phase 37
Annapurna Planned-only domain No apps/annapurna/* or libs/annapurna/* yet Phase 68
Aphrodite Implemented app/library domain apps/aphrodite/*, libs/aphrodite/*, testing/chaos/aphrodite/* Phase 20
Arete Implemented app/library domain apps/arete/*, libs/arete/* Phase 28
Asase Implemented app/library domain apps/asase/*, libs/asase/* Phase 56
Athena Planned-only domain No apps/athena/* or libs/athena/* yet Phase 67, Phase 136
Bellona Implemented app/library domain apps/bellona/*, libs/bellona/* Phase 8, Phases 70-73, 84, 137-174 integration, Phase 180
Brigid Implemented app/library domain apps/brigid/*, libs/brigid/* Phase 59
Calliope Implemented library domain libs/calliope/* Phase 66
Concordia Planned cross-domain mediation substrate Planned services/concordia/*, testing/concordia/*, apps/oshun/web/.../concordia-* Phase 179
Contracts Implemented contract domain libs/contracts/* Phase 4, cross-domain phases
Cybele Implemented app/library domain apps/cybele/*, libs/cybele/* Phase 58
Demeter Implemented app/library domain apps/demeter/*, libs/demeter/* Phase 29
Euterpe Implemented library domain libs/euterpe/* Phase 38, Phase 74, Phases 132-133, 148, 167
Freya Implemented app/library domain apps/freya/*, libs/freya/* Phase 57
Gaia Planned-only domain Planned libs/gaia/* weather and climate ML packages Phase 175
Galatea Implemented library domain libs/galatea/* Phase 63, Phases 155, 162
Hathor Implemented app/library domain apps/hathor/*, libs/hathor/* Phase 7, Phases 81-84, 141, 156, 171-174
Hestia Implemented app/library domain apps/hestia/*, libs/hestia/* Phase 30
Iris Implemented app/library domain apps/iris/*, libs/iris/*, infra/k8s/iris/*, infra/monitoring/iris/* Phase 54, Phases 85, 90, 93, 97-98
Isis Implemented app/library domain apps/isis/*, libs/isis/*, docker/runpod/*, infra/runpod/* Phase 5, Phase 71, Phases 85, 87
Kuanyin Implemented library domain libs/kuanyin/* Phase 32, Phase 80, Phase 90
Lakshmi Planned-only domain No apps/lakshmi/* or libs/lakshmi/* yet Phase 61
Lilith Implemented app/library domain apps/lilith/*, libs/lilith/* Phase 10, Phase 15, Phase 22
Maat Implemented app/library domain apps/maat/*, libs/maat/* Phase 55, Phase 92
Maya Implemented library domain libs/maya/* Phase 40, Phases 76-80, 84, 137, 140, 159, 164-167, 171-174
Meditation Implemented shared wellness library layer libs/meditation/* Phase 22
Metis Implemented app/library/service domain apps/metis/*, libs/metis/*, services/metis/* Phase 25
Mnemosyne Implemented library domain libs/mnemosyne/* Phase 39
Neith Implemented library domain libs/neith/* Phases 41-46, 93, 132-135, 137-174
Nike Legacy planned-only domain No apps/nike/* or libs/nike/*; historical Phase 15 work lives in Lilith/Shakti paths Phase 15
Nisaba Implemented library domain libs/nisaba/* Phase 65
Nous Implemented library domain libs/nous/* Phase 47, Phases 85-98, 176-179
Nyx Implemented app/library domain apps/nyx/*, libs/nyx/*, deploy/nyx/* Phase 21
OpenAPI Implemented API specification domain libs/openapi/*, openapi/*, tools/codegen/* Phase 4, contract phases
Oshun Implemented app/library meta-domain apps/oshun/*, libs/oshun/* Phase 48, Phase 97
Oya Partially implemented library domain libs/oya/core Phase 33
Phoebe Planned-only domain Planned libs/phoebe/* and libs/contracts/phoebe/* (BCI / neuroscience / clinical) Phase 181
Proto Implemented protocol contract domain libs/proto/* Phase 4, contract phases
Psyche Implemented app/library/service domain apps/psyche/*, libs/psyche/*, services/psyche/*, infra/k8s/psyche/* Phase 24, Phases 85, 93, 98, 162, 166-167, 180
Saraswati Implemented library domain libs/saraswati/*, deploy/helm/saraswati-service/* Phase 60
Seshat Implemented library domain libs/seshat/* Phase 36
Shakti Implemented library domain libs/shakti/* Phase 31, Phase 15
Shared Implemented infrastructure domain libs/shared/*, shared docker/*, deploy/*, infra/*, testing/* Phases 0-3, 11-14, 18-19, 49-52, 95, 145-152 integration
Sophia Implemented app/library domain apps/sophia/*, libs/sophia/* Phase 6, Phase 23, Phases 85, 87, 91, 98
Tara Implemented app/library/tool domain apps/tara/*, libs/tara/*, tools/tara/*, infra/terraform/tara/*, tara/* Phase 22
Themis Implemented library domain libs/themis/* Phase 64, Phases 74-75, Phase 76
Kalika Implemented app/library domain apps/kalika/*, libs/kalika/* Phases 99-131
Uzume Implemented library domain libs/uzume/* Phase 62, Phases 132, 148, 167
Veritas Implemented app/library domain apps/veritas/*, libs/veritas/* Phase 23, Phase 75, Phase 91
Yemaya Implemented app/library domain apps/yemaya/*, libs/yemaya/*, deploy/yemaya/* Phase 9, Phases 26-27, 69-70, 135, 141, 147, 153, 158, 163

Source Coverage Registry#

The split TODOS/phase-*.md files are the atomic implementation checklist. DOMAINS/ is the canonical specification and ownership source. Every roadmap phase, planned package root, and standalone TODO source below has an owning domain entry so future implementation can work backward from any source without losing intent.

Source Captured in DOMAINS ownership
TODOS/index.md Roadmap phase table below plus all domain feature/specification files
TODOS/phase-0.md through TODOS/phase-181.md Roadmap phase table below; domain-specific details in the owning domain folders
TODOS/phase-180-reference.md, TODOS/phase-180-gaps.md DOMAINS/bellona/* remote-control sections, with Psyche fallback primitives and the Phase 180 row below
Phase companion artifacts (TODOS/phase-N-*.md: evidence ledgers, audits, gap notes, reference/compliance matrices) Companion artifacts of their parent phase; owned by the same roadmap-phase rows below, no standalone scope
TODOS.md Legacy monolithic roadmap mirror; covered by the split TODOS/ phase rows
docs/audits/OSHUN_APP_TODOS.md, docs/audits/OSHUN_STUDIO_TODOS.md, docs/audits/OSHUN_WEB_APP_TODOS_2.md, docs/audits/OSHUN_WEB_APP_TODOS_3.md, docs/releases/v1/specs/todos.md DOMAINS/oshun/*, with Shared, Iris, Veritas, Nyx, Tara, Arete, Metis, and domain adapters where named (archived under docs/audits/ by the 2026-07-16 R-3 root cleanup)
Archived audit-era TODO reports (docs/audits/AGENTIC_CONTENT_AUTONOMY_GAP_CLOSURE_TODOS_2026-06-17.md, docs/audits/AGENTIC_CONTENT_GAP_CLOSURE_TODOS_2026-06-14.md, docs/audits/AGENTIC_CONTENT_QUALITY_TODOS_2026-06-13.md, docs/audits/AGENTIC_SOTA_IMPLEMENTATION_TODOS.md, docs/audits/HERMES_PARITY_TODOS.md, docs/audits/METIS_GAP_CLOSURE_TODOS_2026-06-16.md, docs/audits/V1_SOTA_AUDIT_REMEDIATION_TODOS_2026-07-02.md) Historical execution ledgers, archived in place; scope captured by the owning domain folders (Isis, Metis, Hathor, Yemaya, Oshun) at completion time
docs/audits/TODO_BURNDOWN.md Regenerable marker burn-down ledger (tools/audit/todo-burndown.mjs); owners are the per-surface rows inside it
docs/presentations/presentation-center/TODOS.md Presentation-library completion and coverage audit across the V1–V10 product trees and all domain documentation; source ownership remains with the respective products and domains.
V-series product ledgers (V1/TODOS.md, V2/V2_TODOS.md, V3/V3_TODOS.md, V4/V4_TODOS.md, V5/V5_TODOS.md, V6/V6_TODOS.md, V7/V7_TODOS.md, V8/V8_TODOS.md, V9/V9_TODOS.md, V10/V_SERIES_AMBIENT_RAIL_TODOS_2026-07-16.md) Owned by their product trees (V<N>/*_features.md, V<N>/*_ARCHITECTURE.md); products are a separate taxonomy from domains
Active planning ledgers (HATHOR_YEMAYA_IDEATION_SOTA_TODOS_2026-07-17.md, V1_V9_AUTONOMOUS_CONTENT_SOTA_GAP_CLOSURE_TODOS_2026-07-15.md, ISIS_GAPS/ISIS_GAPS_TODOS.md) DOMAINS/hathor/* + DOMAINS/yemaya/*, the V1–V9 product trees, and DOMAINS/isis/* respectively; root placement is per the active-planning convention
Root workbench ledgers (TARA_CONTENT_WORKBENCH_TODOS_2026-07-19.md, V1_DOMAIN_WORKBENCHES_TODOS_2026-07-23.md) DOMAINS/tara/* for Tara; DOMAINS/isis/*, DOMAINS/metis/*, DOMAINS/yemaya/*, DOMAINS/veritas/*, DOMAINS/euterpe/*, DOMAINS/aja/*, DOMAINS/bellona/*, and Shared for the seven-domain ledger
ISIS_TODOS.md, ISIS_TODOS_2.md DOMAINS/isis/* plus the Isis remediation docs under docs/domains/isis/*
minerva/TODOS.md and Minerva PRD/audit reports DOMAINS/metis/*, with Sophia and Iris integrations
serwaa/TODOS.md and Serwaa PRD/changelog DOMAINS/psyche/*, with Shared and Iris integrations
yaa/TODOS.md and Yaa PRD/integration docs DOMAINS/veritas/*, with Sophia integrations
docs/proposals/NEITH_TODOS_*.md and Neith proposal docs DOMAINS/neith/*, with Bellona, Maya, Aja, Hathor, Yemaya, Euterpe, Uzume, Psyche, Shared, and Aje integrations where named
Root analysis and recommendation docs (ARCHITECTURE.md, RESPONSIBILITY_SPLIT_RECOMMENDATION.md, OSHUN_*_ANALYSIS.md, OSHUN_VS_*_GAP_ANALYSIS.md) Used as supporting sources for the root DOMAINS.md, this coverage index, and affected domain boundaries

Roadmap Phase Ownership#

Phase range Roadmap scope Owning domain docs
0-2 Pre-migration, package manager consolidation, Nx workspace initialization Shared, Oshun
3 Shared foundation libraries Shared
4 Contracts and schema layer Contracts, OpenAPI, Proto
5 Isis migration Isis
6 Sophia migration Sophia
7 Hathor migration Hathor
8 Bellona migration Bellona
9 Yemaya reorganization Yemaya
10 Lilith reorganization Lilith
11 Cross-domain integration Oshun, Contracts, Shared
12 CI/CD and DevOps consolidation Shared
13 Testing and validation Shared
14 Documentation and cleanup Shared, this coverage index
15 Nike physical wellness and fitness instruction Nike, Lilith, Shakti
16 Aja video-to-animation and motion intelligence Aja
17 State-of-the-art AI service integration Nous, Isis, Iris, Psyche, Sophia
18 Production readiness remediation Shared, Oshun
19 AWS ECS and RunPod serverless infrastructure Shared, Isis, Nous
20 Eve/Aphrodite adult live streaming platform integration Aphrodite, Kuanyin, Themis, Maat, Aje, Aja, Isis, Oya
21 Nyx cosmic observatory and astronomy exploration Nyx
22 Tara meditation platform Tara, Meditation, Lilith
23 Veritas autonomous AI news agency integration Veritas, Sophia
24 Psyche hyper-realistic AI virtual assistant Psyche
25 Metis educational content platform Metis, Sophia, Iris
26 Yemaya autonomous production platform Yemaya
27 Project Obsidian franchise production Yemaya, Hathor, Isis, Bellona, Sophia
28 Arete personal development Arete
29 Demeter home gardening Demeter
30 Hestia culinary intelligence Hestia
31 Shakti movement intelligence Shakti
32 Kuanyin compassionate guardianship Kuanyin
33 Oya drone and swarm management Oya
34 Aglaea fashion, beauty, and style Aglaea
35 Airmid phytotherapy and botanical intelligence Airmid
36 Seshat dwelling arts and craftsmanship Seshat
37 Aje blockchain and Web3 Aje
38 Euterpe music and sonic creation Euterpe
39 Mnemosyne humanistic learning and culture Mnemosyne
40 Maya infinite virtual universe Maya
41-46 Neith sovereign stack, engine, studio, OS, browser Neith
47 Nous sovereign AI platform Nous
48 Oshun domain integration (Neith engine migration and metaverse platform) Oshun, Neith
49 Infrastructure and DevOps (@neith/cloud, @neith/observability, @neith/security) Shared, Neith
50 Testing and quality assurance (@neith/testing, @neith/qa) Shared, Contracts, Neith
51 Documentation and training (@neith/docs, @neith/training) Shared, Neith, all domain docs
52 Release and distribution (@neith/release) Shared, Neith
53 SOTA cross-domain enhancements (@neith/* renderer/procgen/AI + @nous/vision) Neith, Nous
54 Iris universal intelligent assistant Iris
55 Maat autonomous organization operating system Maat
56 Asase food and agriculture operations Asase
57 Freya luxury goods and fashion intelligence Freya
58 Cybele real estate and construction intelligence Cybele
59 Brigid industrial automation intelligence Brigid
60 Saraswati advanced technology intelligence Saraswati
61 Lakshmi personal finance intelligence Lakshmi
62 Uzume live performance and stagecraft Uzume
63 Galatea humanoid robotics and fashion robotics Galatea
64 Themis governance intelligence Themis
65 Nisaba ancient text analysis Nisaba
66 Calliope AI artist creation and management Calliope
67 Athena maker and workshop operations Athena
68 Annapurna restaurant and culinary operations Annapurna
69 Yemaya remote filmmaking Yemaya
70 Production and filmmaking SOTA gap closure Yemaya, Isis, Bellona, Aja, Uzume, Euterpe, Oshun, Shared
71 3D generation SOTA Isis, Bellona, Yemaya, Maya
72 Game engine industrial SOTA gap closure Bellona, Maya, Neith
73 Immersive VR production studio Yemaya, Isis, Bellona, Maya, Psyche
74 Themis music shield Themis, Euterpe, Calliope, Veritas
75 Themis universal originality shield Themis, Isis, Yemaya, Veritas
76 Maya Forge modding and governance Maya, Themis
77 Maya Nexus multiplayer SOTA Maya
78 Maya Forge AI modding companion Maya, Iris
79 Immersive open world SOTA Maya, Hathor, Isis, Bellona
80 Maya social fabric SOTA Maya, Kuanyin, Themis
81 NPC cognitive core and on-device SLM Hathor, Maya, Nous, Iris
82 Voice-first gameplay input Hathor, Maya, Iris, Psyche
83 NPC emergent agency and living world evolution Hathor, Maya
84 Combat systems SOTA Maya, Hathor, Bellona, Aja
85 ML sovereignty data flywheel core Nous, Iris, Psyche, Isis, Sophia, Hathor, Yemaya, Veritas, Metis
86 ML sovereignty data flywheel extended Nous plus all domain docs
87 Dataset management and synthetic data generation Nous, Sophia, Isis, Shared
88 Production model serving Nous, Shared
89 Training and fine-tuning infrastructure Nous, Shared
90 Alignment and safety training Nous, Kuanyin, Themis, Iris
91 Continuous evaluation and benchmarking Nous, Veritas, Sophia, Shared
92 MLOps, experiment management, and governance Nous, Maat, Shared
93 Edge and on-device deployment Nous, Neith, Psyche, Iris
94 Domain-specific training pipelines Nous plus the relevant domain docs
95 GPU infrastructure and training clusters Shared, Nous
96 SOTA open-weight model integration Nous
97 Skills system and cross-domain composition Oshun, Iris, Nous, Shared
98 AI platform completion Iris, Sophia, Nous, Psyche, Shared
99-131 Kalika mathematics, physics, materials science, and reproducible scientific compute Kalika
132 Sovereign audio runtime and plugin platform Neith, Euterpe, Uzume, Yemaya
133 Composer DAW SOTA expansion Neith, Euterpe
134 Forge 2D sovereign creative suite Neith
135 VFX compositor, post-production, delivery, and virtual production Neith, Yemaya, Bellona
136 Athena sovereign CAD / EDA / CAM / GIS kernel Athena
137 Platform and live-service sovereignty Neith, Maya, Bellona
138 DCC and rendering depth parity Neith, Bellona
139 Sovereign office, scholarly authoring, and collaboration suite Neith, Oshun, Shared
140 Sovereign cloud gaming platform Neith, Maya, Bellona
141 Sovereign 2D animation suite Neith, Yemaya, Hathor
142 Sovereign product analytics and experimentation Neith, Shared, Maat
143 DCC competitor depth parity Neith, Bellona
144 Sovereign real-time visualization renderers Neith, Bellona, Athena, Cybele, Seshat
145 Sovereign CI/CD and software supply-chain platform Neith, Shared
146 Sovereign identity provider Neith, Shared
147 Sovereign specialist colorist suite Neith, Yemaya
148 Sovereign DJ workstation Neith, Euterpe, Uzume
149 Sovereign crash analytics and error tracking Neith, Shared
150 Sovereign password manager and secrets vault Neith, Shared
151 Sovereign EDR / XDR suite Neith, Shared
152 Sovereign incident management and on-call platform Neith, Shared
153 Sovereign VFX match-move and 3D camera tracking suite Neith, Yemaya, Aja, Bellona
154 Neith EEVEE-class real-time rasterizer Neith, Bellona
155 Neith curves-based hair and grooming system Neith, Galatea
156 Neith Grease Pencil-class 2D-in-3D animation Neith, Aja, Hathor
157 Neith Mantaflow-class fluid, smoke, fire, pyro, and particles simulation Neith, Bellona
158 Neith DCC-integrated video sequence editor Neith, Yemaya
159 Neith engine online subsystem and replication Neith, Maya, Bellona
160 Neith engine frame profiler and diagnostics Neith, Bellona, Shared
161 Neith Niagara-class GPU VFX authoring editor Neith, Bellona, Yemaya
162 Neith MetaHuman-class digital human pipeline Neith, Psyche, Galatea, Aja
163 Neith virtual production stack Neith, Yemaya, Bellona
164 Neith engine monetization and LiveOps stack Neith, Maya, Aje
165 Neith engine creator marketplace and asset store Neith, Maya, Oshun
166 Neith spatial computing and visionOS runtime Neith, Psyche, Maya
167 Neith engine audio architecture depth Neith, Euterpe, Uzume, Psyche, Maya
168 Neith modern global illumination pipeline Neith, Bellona
169 Neith GPU compute shader framework Neith, Nous, Isis, Bellona
170 Neith sculpting depth plus NPR / Freestyle line rendering Neith, Bellona
171-174 Unreal Engine and Blender final parity sweeps Neith, Bellona, Maya, Aja, Hathor, Yemaya
175 Sovereign weather and climate ML Gaia, Nous, Asase, Demeter, Oya, Cybele, Galatea, Lakshmi, Uzume, Aphrodite, Veritas, Kuanyin, Shared
176 Neural world models and latent dynamics Nous, Maya, Galatea, Hathor, Iris, Psyche, Metis, Kuanyin, Shared
177 Interpretability and continual-learning research Nous, Kuanyin, Galatea, Iris, Veritas, Mnemosyne, Sophia, Metis, Shared
178 Autonomous research and agentic scientist Nous, Kalika, Sophia, Metis, Mnemosyne, Nisaba, Veritas, Iris, Shared, Maat, Kuanyin
179 Concordia cooperative mediation and negotiation intelligence Concordia, Nous, Iris, Themis, Maat, Kuanyin, Aje, Contracts, OpenAPI, Proto, Sophia, Oshun, Shared
180 Remote creative control plane (remote host, Blender/Unreal deep control, browser automation, computer-use fallback, control room, cloud gateway, MCP) Bellona, Psyche, Yemaya, Iris, Nous, Oshun, Contracts, OpenAPI, Proto, Shared
181 Phoebe BCI, neuroscience, clinical psychology, and autonomous discovery platform Phoebe, Nous, Kalika, Psyche, Iris, Kuanyin, Shared

Cross-Cutting Scope Rules#

  • Infrastructure, testing, release, documentation, and DevOps phases are owned by DOMAINS/shared/* unless a phase names a more specific domain.
  • Contract and schema work is split across DOMAINS/contracts/*, DOMAINS/openapi/*, and DOMAINS/proto/*.
  • ML sovereignty work is centered in DOMAINS/nous/*, with domain-specific data producers documented in each participating domain.
  • Weather and climate ML work is centered in DOMAINS/gaia/*; consuming domains own their own weather-informed decisions and user-facing workflows.
  • Cooperative bargaining and mediation orchestration is centered in DOMAINS/concordia/*, while model/search primitives remain in Nous, legal and governance policy remains in Themis/Kuanyin/Maat, settlement remains in Aje, and contracts remain in Contracts/OpenAPI/Proto.
  • Skills-system work is centered in DOMAINS/oshun/* and DOMAINS/iris/*, with runtime, model, and governance dependencies covered by Nous and Shared.
  • External root projects (minerva/, serwaa/, yaa/) are captured in the root DOMAINS.md external-project registry and by their integration domains: Metis, Psyche, and Veritas.