# OSHUN Studio Bellona Unity 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/unity-bridge-commands/page.tsx`

## Purpose

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

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

## 1. Navigation Entry

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

## 2. Canonical Route Map

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

## 3. Route Governance Rules

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

## 4. Acceptance Criteria (OST-00339)

`OST-00339` is complete only when:

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