# Bellona Domain Feature Inventory

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

## Overview

Build and Bridge Platform for Game Engines and Creative Tools

## Coverage Summary

- Domain slug: `bellona`
- TODO phase coverage: `8`
- Checklist-derived feature items: 129
- 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/bellona/`

## Capability Pillars

| Capability Pillar                  | Primary Source                   | Status                |
| ---------------------------------- | -------------------------------- | --------------------- |
| Executive Summary                  | docs/domains/bellona/features.md | implementation-backed |
| Live Engine Bridges                | docs/domains/bellona/features.md | implementation-backed |
| Asset Interchange                  | docs/domains/bellona/features.md | implementation-backed |
| Build System                       | docs/domains/bellona/features.md | implementation-backed |
| Export Pipeline                    | docs/domains/bellona/features.md | implementation-backed |
| Engine Synchronization             | docs/domains/bellona/features.md | implementation-backed |
| Gameplay Runtime Systems           | docs/domains/bellona/features.md | implementation-backed |
| Virtual Production                 | docs/domains/bellona/features.md | implementation-backed |
| Extended Reality (XR)              | docs/domains/bellona/features.md | implementation-backed |
| Motion Capture                     | docs/domains/bellona/features.md | implementation-backed |
| MetaHuman Pipeline                 | docs/domains/bellona/features.md | implementation-backed |
| OpenUSD Pipeline                   | docs/domains/bellona/features.md | implementation-backed |
| DaVinci Resolve Integration        | docs/domains/bellona/features.md | implementation-backed |
| Houdini Integration (Beta)         | docs/domains/bellona/features.md | implementation-backed |
| Command-Line Interface (CLI)       | docs/domains/bellona/features.md | implementation-backed |
| TypeScript SDK                     | docs/domains/bellona/features.md | implementation-backed |
| Cross-Domain Integration           | docs/domains/bellona/features.md | implementation-backed |
| Rendering                          | docs/domains/bellona/features.md | implementation-backed |
| C++ Native SDK                     | docs/domains/bellona/features.md | implementation-backed |
| Platform Availability              | docs/domains/bellona/features.md | implementation-backed |
| Engine and Platform Support Matrix | docs/domains/bellona/features.md | implementation-backed |
| Audit and Monitoring               | docs/domains/bellona/features.md | implementation-backed |

## Implementation-Derived Capability Surfaces

| Category    | Path                                  | Inferred Capability Surface |
| ----------- | ------------------------------------- | --------------------------- |
| Application | `apps/bellona/bridge-blender/`        | Bridge Blender              |
| Application | `apps/bellona/bridge-godot/`          | Bridge Godot                |
| Application | `apps/bellona/bridge-unity/`          | Bridge Unity                |
| Application | `apps/bellona/bridge-unreal/`         | Bridge Unreal               |
| Application | `apps/bellona/build-api/`             | Build Api                   |
| Application | `apps/bellona/build-worker/`          | Build Worker                |
| Application | `apps/bellona/cli/`                   | Cli                         |
| Application | `apps/bellona/control-room/`          | Control Room                |
| Application | `apps/bellona/remote-gateway/`        | Remote Gateway              |
| Application | `apps/bellona/remote-host/`           | Remote Host                 |
| Application | `apps/bellona/render-api/`            | Render Api                  |
| Library     | `libs/bellona/3dsmax/`                | 3dsmax                      |
| Library     | `libs/bellona/adapters/`              | Adapters                    |
| Library     | `libs/bellona/asset-export/`          | Asset Export                |
| Library     | `libs/bellona/audio/`                 | Audio                       |
| Library     | `libs/bellona/blender/`               | Blender                     |
| Library     | `libs/bellona/blender-agent/`         | Blender Agent               |
| Library     | `libs/bellona/bridge-core/`           | Bridge Core                 |
| Library     | `libs/bellona/client/`                | Client                      |
| Library     | `libs/bellona/cross-dcc-consistency/` | Cross Dcc Consistency       |
| Library     | `libs/bellona/database/`              | Database                    |
| Library     | `libs/bellona/davinci/`               | Davinci                     |
| Library     | `libs/bellona/editor-productization/` | Editor Productization       |
| Library     | `libs/bellona/event-handlers/`        | Event Handlers              |
| Library     | `libs/bellona/event-publisher/`       | Event Publisher             |
| Library     | `libs/bellona/gameplay-systems/`      | Gameplay Systems            |
| Library     | `libs/bellona/godot/`                 | Godot                       |
| Library     | `libs/bellona/houdini/`               | Houdini                     |
| Library     | `libs/bellona/integration/`           | Integration                 |
| Library     | `libs/bellona/interchange/`           | Interchange                 |
| Library     | `libs/bellona/interchange-models/`    | Interchange Models          |
| Library     | `libs/bellona/maya/`                  | Maya                        |
| Library     | `libs/bellona/mcp-gateway/`           | Mcp Gateway                 |
| Library     | `libs/bellona/metahuman/`             | Metahuman                   |
| Library     | `libs/bellona/mocap/`                 | Mocap                       |
| Library     | `libs/bellona/openusd/`               | Openusd                     |
| Library     | `libs/bellona/README.md`              | README.md                   |
| Library     | `libs/bellona/remote-protocol/`       | Remote Protocol             |
| Library     | `libs/bellona/sdk-cpp/`               | Sdk Cpp                     |
| Library     | `libs/bellona/unity/`                 | Unity                       |
| Library     | `libs/bellona/unity-agent/`           | Unity Agent                 |
| Library     | `libs/bellona/unreal/`                | Unreal                      |
| Library     | `libs/bellona/video/`                 | Video                       |
| Library     | `libs/bellona/virtual-production/`    | Virtual Production          |
| Library     | `libs/bellona/xr/`                    | Xr                          |

## Canonical Standalone Feature Coverage

| Heading Level | Feature Family                     |
| ------------- | ---------------------------------- |
| H2            | Executive Summary                  |
| H2            | Live Engine Bridges                |
| H3            | How Bridges Work                   |
| H3            | Unity Bridge (14 Commands)         |
| H3            | Unreal Engine Bridge (11 Commands) |
| H3            | Godot Bridge (9 Commands)          |
| H3            | Blender Bridge (6 Commands)        |
| H3            | Bridge Protocol Features           |
| H2            | Asset Interchange                  |
| H3            | Supported Formats                  |
| H3            | Interchange Workflow               |
| H3            | Batch Conversion                   |
| H3            | Asset Cache                        |
| H3            | Format Registry                    |
| H2            | Build System                       |
| H3            | Build Jobs                         |
| H3            | Build Job Types                    |
| H3            | Build Status Tracking              |
| H3            | Build Artifacts                    |
| H3            | Build Templates                    |
| H3            | Content-Addressable Build Cache    |
| H2            | Export Pipeline                    |
| H3            | Export Formats                     |
| H3            | Engine-Specific Export             |
| H3            | Export Workflow                    |
| H3            | Build-to-Export Pipeline           |
| H2            | Engine Synchronization             |
| H3            | Sync Directions                    |
| H3            | Conflict Resolution                |
| H3            | Engine-Specific Sync               |
| H2            | Gameplay Runtime Systems           |
| H3            | Input System                       |
| H3            | Save/Load System                   |
| H3            | Inventory System                   |
| H3            | Combat System                      |
| H3            | AI Behavior Systems                |
| H2            | Virtual Production                 |
| H3            | Camera Tracking Integration        |
| H3            | LED Wall Control                   |
| H3            | ICVFX Compositing                  |
| H3            | Synchronization                    |
| H3            | Preset Configurations              |
| H2            | Extended Reality (XR)              |
| H3            | Platform Support                   |
| H3            | visionOS Features                  |
| H3            | Meta Quest Features                |
| H3            | Shared XR Capabilities             |
| H2            | Motion Capture                     |
| H3            | Multi-Vendor Streaming             |
| H3            | Skeleton Management                |
| H3            | Retargeting                        |
| H3            | Recording and Playback             |
| H3            | File Format Support                |
| H3            | Animation Output                   |
| H2            | MetaHuman Pipeline                 |
| H3            | Mesh Import                        |
| H3            | Face Rig                           |
| H3            | Body Customization                 |
| H3            | Live Link Animation                |
| H2            | OpenUSD Pipeline                   |
| H3            | USD Stage Management               |
| H3            | Layer and Composition              |
| H3            | Variant Management                 |
| H3            | MaterialX Integration              |
| H3            | Pipeline Tools                     |
| H3            | Import/Export                      |
| H2            | DaVinci Resolve Integration        |
| H2            | Houdini Integration (Beta)         |
| H3            | HDA Asset Pipeline                 |
| H3            | USD Pipeline                       |
| H2            | Command-Line Interface (CLI)       |
| H3            | Commands                           |
| H3            | Configuration                      |
| H2            | TypeScript SDK                     |
| H3            | Build Operations                   |
| H3            | Export Operations                  |
| H3            | Engine Sync Operations             |
| H2            | Cross-Domain Integration           |
| H3            | Automatic Asset Ingestion          |
| H3            | Lore-to-Engine Compilation         |
| H3            | AI Asset Pipeline                  |
| H3            | Events Published by Bellona        |
| H2            | Rendering                          |
| H3            | GPU Render Queue                   |
| H2            | C++ Native SDK                     |
| H2            | Platform Availability              |
| H2            | Engine and Platform Support Matrix |
| H2            | Audit and Monitoring               |

## Detailed TODO Phase Coverage

### Phase 8: Bellona (Engine & Build/Bridge) Migration

- Checklist items captured: 129
- Source: `TODOS.md`

#### 8.1 Bellona Library: Engine Adapters ✅

- [x] **8.1.1** Create libs/bellona/adapters/ project
- [x] **8.1.2** Add project.json with scope:bellona, layer:domain tags

#### 8.2 Bellona Library: Godot Adapter ✅

- [x] **8.2.1** Create libs/bellona/godot/ project
- [x] **8.2.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.2.3** Create GodotBridge WebSocket communication (replaces migration
      plan)
- [x] **8.2.4** Create version discovery and launcher utilities
- [x] **8.2.5** Create scene management utilities (SceneParser, SceneWriter)
- [x] **8.2.6** Create project management utilities (ProjectParser,
      ProjectWriter, ProjectManager)
- [x] **8.2.7** Create scripting module stub (implementation in future phase)
- [x] **8.2.8** Create export module stub (implementation in future phase)
- [x] **8.2.9** Create asset management module stub (implementation in future
      phase)

#### 8.3 Bellona Library: Unreal Adapter ✅

- [x] **8.3.1** Create libs/bellona/unreal/ project
- [x] **8.3.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.3.3** Migrate yemaya/packages/unreal
- [x] **8.3.4** Create plugin communication layer (Remote Control API
      integration)
- [x] **8.3.5** Create asset pipeline integration (AssetTools with FBX import,
      materials, textures, LOD, collision, animation, physics assets, PBR
      workflow)
- [x] **8.3.6** Create MetaHuman integration (MetaHumanMeshImporter,
      FaceRigMapper with ARKit blendshapes, AppearanceEditor, LiveLinkClient)

#### 8.4 Bellona Library: Unity Adapter ✅

- [x] **8.4.1** Create libs/bellona/unity/ project
- [x] **8.4.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.4.3** Migrate yemaya/packages/unity
- [x] **8.4.4** Create plugin communication layer
- [x] **8.4.5** Create Gaussian Splatting plugin integration

#### 8.5 Bellona Library: Blender Adapter ✅

- [x] **8.5.1** Create libs/bellona/blender/ project
- [x] **8.5.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.5.3** Migrate yemaya/packages/blender
- [x] **8.5.4** Create Python API bridge via WebSocket
- [x] **8.5.5** Create automation utilities
- [x] **8.5.6** Create render cost tracking
- [x] **8.5.7** Create asset pipeline integration

#### 8.6 Bellona Library: Houdini Adapter ✅

- [x] **8.6.1** Create libs/bellona/houdini/ project
- [x] **8.6.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.6.3** Migrate yemaya/packages/houdini
- [x] **8.6.4** Create procedural world tools integration

#### 8.7 Bellona Library: DaVinci Adapter ✅

- [x] **8.7.1** Create libs/bellona/davinci/ project
- [x] **8.7.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.7.3** Migrate yemaya/packages/davinci
- [x] **8.7.4** Create video editing integration
- [x] **8.7.5** Create color grading integration

#### 8.8 Bellona Library: OpenUSD Pipeline ✅

- [x] **8.8.1** Create libs/bellona/openusd/ project
- [x] **8.8.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.8.3** Migrate yemaya/packages/openusd
- [x] **8.8.4** Create USD asset management
- [x] **8.8.5** Create composition utilities
- [x] **8.8.6** Create pipeline tools

#### 8.9 Bellona Library: Import/Export Pipelines ✅

- [x] **8.9.1** Create libs/bellona/interchange/ project
- [x] **8.9.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.9.3** Create GLTF import/export
- [x] **8.9.4** Create USD import/export
- [x] **8.9.5** Create FBX import/export
- [x] **8.9.6** Create asset transform utilities
- [x] **8.9.7** Create validation pipeline

#### 8.10 Bellona Library: Scene/Animation/Material Models ✅

- [x] **8.10.1** Create libs/bellona/interchange-models/ project
- [x] **8.10.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.10.3** Create scene interchange model
- [x] **8.10.4** Create animation interchange model
- [x] **8.10.5** Create material interchange model
- [x] **8.10.6** Create converters to/from engine formats

#### 8.11 Bellona Library: Virtual Production ✅

- [x] **8.11.1** Create libs/bellona/virtual-production/ project
- [x] **8.11.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.11.3** Migrate yemaya/packages/virtual-production
- [x] **8.11.4** Create LED wall integration
- [x] **8.11.5** Create camera tracking integration
- [x] **8.11.6** Create virtual camera utilities

#### 8.12 Bellona Library: MoCap ✅

- [x] **8.12.1** Create libs/bellona/mocap/ project
- [x] **8.12.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.12.3** Migrate yemaya/packages/mocap
- [x] **8.12.4** Create markerless mocap pipeline
- [x] **8.12.5** Create marker-based mocap pipeline
- [x] **8.12.6** Create Audio2Face integration
- [x] **8.12.7** Create retargeting utilities

#### 8.13 Bellona Library: Video Production ✅

- [x] **8.13.1** Create libs/bellona/video/ project
- [x] **8.13.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.13.3** Migrate yemaya/packages/video (non-AI parts)
- [x] **8.13.4** Create editing integration
- [x] **8.13.5** Create VFX pipeline

#### 8.14 Bellona Library: Audio Production (Ardour) ✅

- [x] **8.14.1** Create libs/bellona/audio/ project
- [x] **8.14.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.14.3** Migrate yemaya/packages/audio (non-AI parts)
- [x] **8.14.4** Create Ardour integration
- [x] **8.14.5** Create DAW session control
- [x] **8.14.6** Create routing utilities
- [x] **8.14.7** Create export automation

#### 8.15 Bellona Library: Gameplay Systems

- [x] **8.15.1** Create libs/bellona/gameplay-systems/ project
- [x] **8.15.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.15.3** Migrate yemaya/packages/gameplay-systems
- [x] **8.15.4** Create input system
- [x] **8.15.5** Create save system
- [x] **8.15.6** Create inventory system
- [x] **8.15.7** Create combat system
- [x] **8.15.8** Create AI behavior system

#### 8.16 Bellona Library: XR

- [x] **8.16.1** Create libs/bellona/xr/ project
- [x] **8.16.2** Add project.json with scope:bellona, layer:domain tags
- [x] **8.16.3** Migrate yemaya/packages/xr
- [x] **8.16.4** Create visionOS support
- [x] **8.16.5** Create Meta Quest support
- [x] **8.16.6** Create cross-platform XR utilities

#### 8.17 Bellona App: Bridge Services

- [x] **8.17.1** Create apps/bellona/bridge-blender/ project
- [x] **8.17.2** Create apps/bellona/bridge-godot/ project
- [x] **8.17.3** Create apps/bellona/bridge-unreal/ project
- [x] **8.17.4** Create apps/bellona/bridge-unity/ project
- [x] **8.17.5** Add project.json with scope:bellona, type:app tags for each
- [x] **8.17.6** Create WebSocket/IPC services for each engine
- [x] **8.17.7** Add connection management
- [x] **8.17.8** Add command routing

#### 8.18 Bellona App: Build Workers

- [x] **8.18.1** Create apps/bellona/build-worker/ project
- [x] **8.18.2** Add project.json with scope:bellona, type:app tags
- [x] **8.18.3** Create asset baking worker
- [x] **8.18.4** Create validation worker
- [x] **8.18.5** Create engine project generation worker
- [x] **8.18.6** Create export packaging worker

#### 8.19 Bellona Client SDK

- [x] **8.19.1** Create libs/bellona/client/ project
- [x] **8.19.2** Add project.json with scope:bellona, layer:clients tags
- [x] **8.19.3** Generate TypeScript client from OpenAPI
- [x] **8.19.4** Create @oshun/bellona-client package
- [x] **8.19.5** Add build trigger helpers
- [x] **8.19.6** Add export helpers
- [x] **8.19.7** Add engine sync helpers

#### 8.20 Bellona C++ SDK ✅

- [x] **8.20.1** Create libs/bellona/sdk-cpp/ project
- [x] **8.20.2** Add project.json with scope:bellona tags
- [x] **8.20.3** Migrate yemaya/packages/sdk-cpp
- [x] **8.20.4** Update for Bellona APIs

#### 8.21 Bellona Database Schema ✅

- [x] **8.21.1** Create libs/bellona/database/ project
- [x] **8.21.2** Add project.json with scope:bellona, layer:data tags
- [x] **8.21.3** Define Prisma schema for Bellona:
  - [x] Build model
  - [x] BuildArtifact model
  - [x] ExportJob model
  - [x] EngineProject model
  - [x] BridgeSession model
- [x] **8.21.4** Create migrations
- [x] **8.21.5** Add seed data

#### 8.22 Integration with Hathor/Isis ✅

- [x] **8.22.1** Create Bellona → Hathor artifact consumer
- [x] **8.22.2** Create Bellona → Isis asset consumer
- [x] **8.22.3** Add Hathor lore compilation to engine formats

---
