# OSHUN Studio Bellona Unreal Bridge Commands Route Map

Status: Active  
Owner: OSHUN Studio Architecture + Bellona Domain Engineering + OSHUN Web +
Program Operations  
Last Updated: 2026-02-24  
Related:

- `docs/domains/bellona/features.md`
- `docs/domains/bellona/README.md`
- `apps/oshun/web/src/app/studio/bellona/unreal-bridge-commands/page.tsx`

## Purpose

Define dedicated navigation entry points and canonical route structure for the
Bellona Unreal Bridge Commands capability in OSHUN Studio.

This document is the execution artifact for `OST-00357`.

## 1. Navigation Entry

- Studio index entry label: `Open Bellona Unreal Bridge Commands workspace`
- Studio index entry route: `/studio/bellona/unreal-bridge-commands`
- Primary ownership: Bellona Domain Engineering + Studio Web

## 2. Canonical Route Map

| Route                                                              | Scope          | Purpose                                                                   |
| ------------------------------------------------------------------ | -------------- | ------------------------------------------------------------------------- |
| `/studio/bellona/unreal-bridge-commands`                           | GA entry route | Primary workspace shell for Unreal command inventory and expert controls. |
| `/studio/bellona/unreal-bridge-commands/new`                       | planned        | Create/edit wizard route for templates and advanced runtime settings.     |
| `/studio/bellona/unreal-bridge-commands/[commandId]`               | planned        | Command detail route with timeline, diagnostics, and related entities.    |
| `/studio/bellona/unreal-bridge-commands/[commandId]/streams`       | planned        | Real-time command stream state, reconnect, throughput, and health.        |
| `/studio/bellona/unreal-bridge-commands/[commandId]/collaboration` | planned        | Comments, assignments, approvals, and mention workflows.                  |
| `/studio/bellona/unreal-bridge-commands/[commandId]/audit`         | planned        | Audit/change history with reversible operation evidence.                  |

## 3. Route Governance Rules

- All Unreal Bridge Commands routes must remain under `/studio/bellona`.
- Detail routes must use stable `commandId` parameters from Bellona Unreal
  command registry records.
- Route expansion must preserve backward navigation to the primary route.
- Route coverage must remain consistent with the Unreal bridge command surface
  documented in Bellona domain features (14 command families).

## 4. Acceptance Criteria (OST-00357)

`OST-00357` is complete only when:

1. A dedicated studio navigation entry exists for Bellona Unreal Bridge
   Commands.
2. The primary route `/studio/bellona/unreal-bridge-commands` is implemented.
3. A canonical route map document exists with planned subroutes and purposes.
4. Navigation and routing align with Bellona Unreal bridge feature
   documentation.
