# Studio Bellona Build Job Authoring Route Map

## Objective

Define the canonical navigation contract for Bellona Build Job Authoring so
every workflow maps to stable and discoverable routes.

## Implemented Entry Points

- `apps/oshun/web/src/app/studio/bellona/build-job-authoring/page.tsx`
- `apps/oshun/web/src/components/studio/StudioBellonaBuildJobAuthoringWorkspace.tsx`
- `apps/oshun/web/src/app/studio/page.tsx` (Studio index quick action entry)

## Canonical Route

- Studio index entry route: `/studio/bellona/build-job-authoring`

## Route Inventory

| Path                                                       | Status         | Purpose                                                                    |
| ---------------------------------------------------------- | -------------- | -------------------------------------------------------------------------- |
| `/studio/bellona/build-job-authoring`                      | GA entry route | Primary workspace shell for build job authoring and governance controls.   |
| `/studio/bellona/build-job-authoring/new`                  | planned        | Create/edit route for build job definitions and template metadata.         |
| `/studio/bellona/build-job-authoring/[jobId]`              | planned        | Build job detail route for diagnostics, lifecycle, and collaboration.      |
| `/studio/bellona/build-job-authoring/[jobId]/runs/[runId]` | planned        | Run detail route for retries, stream telemetry, and incident traceability. |
| `/studio/bellona/build-job-authoring/[jobId]/audit`        | planned        | Audit route for approvals, ownership traceability, and release evidence.   |

## Validation Notes

1. The Studio index contains a quick action link to
   `/studio/bellona/build-job-authoring`.
2. The primary route `/studio/bellona/build-job-authoring` is implemented.
3. The route map section in the page mirrors this document.
