# Studio vs Yemaya AAA Studio Boundary (§24.11)

This document is the canonical reference for which generation surfaces ship on
the contemplative product (`apps/oshun/web/src/app/studio/`) vs. the AAA-creator
surfaces in Yemaya Studio (`apps/yemaya/studio-web/` and
`apps/yemaya/studio-desktop/`).

The boundary is enforced by `libs/isis/entitlements`'s generation-tier resolver.
Any AAA-tier route reached from the contemplative product is intercepted by
middleware and either rendered as a Yemaya signup CTA (when the user has an
upgrade path) or hard-blocked (404).

## Surface Inventory

| Surface                              | Host App              | Entitlement      | Rationale                               |
| ------------------------------------ | --------------------- | ---------------- | --------------------------------------- |
| Curated illustration card            | Oshun Studio          | curated-creator+ | §24.6 — fixed style presets only        |
| Curated narration card               | Oshun Studio          | curated-creator+ | §24.6 — voice profiles in allowlist     |
| Curated ambient-audio card           | Oshun Studio          | curated-creator+ | §24.6, §24.8 — mood/tempo/duration only |
| Curated explainer card               | Oshun Studio          | curated-creator+ | §24.6 — Sophia evidence pin required    |
| Curated caption/dub card             | Oshun Studio          | curated-creator+ | §24.6, §16.6 — locale parity            |
| Curated accessibility-pass card      | Oshun Studio          | curated-creator+ | §24.6 — alt-text, contrast, transcript  |
| Curated music card                   | Oshun Studio          | curated-creator+ | §24.8 — workflow-class-bound            |
| Nyx sky-event 3D briefing            | Oshun Studio          | curated-creator+ | §24.9 — single read-mostly card         |
| Output gallery                       | Oshun Studio          | curated-creator+ | §24.10 — outputs only, no editor        |
| Graph editor (ComfyUI)               | Yemaya Studio         | aaa-creator      | §24.3 — raw graph access                |
| Civitai search + LoRA hash picker    | Yemaya Studio         | aaa-creator      | §24.2 — operator-grade picker           |
| LoRA trainer                         | Yemaya Studio         | aaa-creator      | §24.5 — rights attestation gate         |
| Model merger / comparison            | Yemaya Studio         | aaa-creator      | §24.5 — provenance bundle, A/B preview  |
| RunPod region selector               | Yemaya Studio         | aaa-creator      | §24.4 — region routing                  |
| GPU worker / multi-GPU orchestration | Yemaya Studio         | aaa-creator      | §24.4 — raw compute control             |
| Gaussian-splatting / auto-rigging    | Yemaya Studio         | aaa-creator      | §24.9 — pipeline-class authoring        |
| Topaz / RIFE / AnimateDiff           | Yemaya Studio         | aaa-creator      | §24.9 — post-process steps              |
| Voice cloning tool                   | Yemaya Studio         | aaa-creator      | §24.7 — consent capture, signoffs       |
| Music stem editor                    | Yemaya Studio         | aaa-creator      | §24.8 — per-stem mix                    |
| Full 3D pipeline editor              | Yemaya Studio         | aaa-creator      | §24.9 — chain authoring                 |
| Civitai intake review queue          | Yemaya Studio (admin) | operator-admin   | §24.2 — license-decision review         |
| LoRA training queue (admin)          | Yemaya Studio (admin) | operator-admin   | §24.5 — eval gate                       |
| RunPod operator dashboard            | Yemaya Studio (admin) | operator-admin   | §24.4 — health, cost, quotas            |
| ComfyUI node registry                | Yemaya Studio (admin) | operator-admin   | §24.3 — deprecation flags               |
| Output gallery (admin)               | Yemaya Studio (admin) | operator-admin   | §24.10 — bulk actions                   |

## Routes Removed From Oshun Studio (§24.11 redirect targets)

All legacy routes under `apps/oshun/web/src/app/studio/isis/` are **not** on the
contemplative product. The following representative route segments are called
out in §24.11 and retained in the diagnostics catalog:

```
3d-editing
3d-generation
3d-post-processing
3d-prompt-engineering
3d-result-management
ai-providers
audio-generation
gpu-worker
gpu-worker-architecture
multi-gpu-orchestration
multi-provider-3d-generation
nvidia-rtx-processing
lora-training
model-merging
model-comparison
music-generation
topaz-enhancement
rife-interpolation
texture-enhancement
topology-verification
gaussian-splatting
auto-rigging
instantid
ip-adapter
controlnet
florence-2
animatediff-lightning
comfyui-nodes
comfyui-sdk
text-to-audio
text-to-speech
```

The Oshun proxy (`apps/oshun/web/src/proxy.ts`) intercepts any GET for
`/studio/isis/<segment>` and:

1. If the user's entitlement tier is `aaa-creator` or `operator-admin`, redirect
   to the Yemaya Studio CTA / signup gate with the original path in `from`.
2. Else respond with a 404 hard-block (no information about the surface is
   revealed).

The Yemaya signup gate page lives at `apps/oshun/web/src/app/aaa-upgrade/`
(rendered for the first case above).

## Deep-Link Promotion

When an AAA-creator finishes a piece in Yemaya Studio and chooses "Promote to
Oshun Output Gallery", Yemaya posts to `POST /api/isis/output-gallery/promote`
with the AAA-side output id + target curated tier metadata. The promotion path
runs the §16 editorial lifecycle, which gates whether the asset ends up on the
contemplative product.

The deep-link spec lives in `libs/isis/output-gallery` (the `lineage.ts` edge
kind `send-to-editorial` is exactly this edge).

## Tests

Coverage of the boundary is enforced by:

- `libs/isis/entitlements/src/generation-tier.test.ts` — every AAA-only surface
  refuses a `contemplative` entitlement.
- `libs/isis/curated-cards/src/curated-cards.test.ts` — `auditRawGraphLeak`
  catches raw model hashes / LoRA / scheduler / graph node ids that would betray
  AAA-tier surfaces inside a contemplative payload.

Both suites must pass before any contemplative-product release.
