# Bellona Remote Creative Control Plane — Documentation Index

The Remote Creative Control Plane (Phase **180.C**) lets a trusted Oshun agent
drive **Blender, Unreal Engine, Chrome/Chromium, and selected desktop
workflows** on a second machine — over the LAN or a cloud tunnel — while an
operator watches and approves through the **Control Room**. It is a standalone
**gateway** (the authority) plus a **host** (on the controlled machine), both
built on one authoritative wire protocol (`@bellona/remote-protocol`), with a
hash-chained audit trail, per-command policy + approvals, and a cross-platform
host runtime.

## Start here

| If you want to…                                                                                                                                 | Read                                                                              |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| **Understand the system** — topology, trust boundaries, protocol, gateway, host, Control Room, cloud                                            | **[Architecture](./architecture.md)** (180.C.29.01)                               |
| **Set it up / operate it** — two-MacBook LAN, Hetzner/AWS, pairing, permissions, Blender/Unreal/browser, approvals, takeover, replay, uninstall | **[User & Operator Guide](./user-operator-guide.md)** (180.C.29.02)               |
| **Extend it** — add a command, adapter, MCP tool, policy rule, approval gate, audit evidence, tests                                             | **[Developer Guide](./developer-guide.md)** (180.C.29.03)                         |
| **Write a third-party adapter** — the `RemoteAdapter` contract, conformance, packaging, versioning/deprecation/migration                        | **[Adapter SDK](./adapter-sdk.md)** (180.C.32.08)                                 |
| **Sign & distribute an adapter** — signed registry, ad-hoc trust model, publisher trust levels, org scope policy                                | **[Adapter Distribution](./adapter-distribution.md)** (180.C.32.09)               |
| **Run the whole spine locally in ~5 minutes** (no Mac/Blender/cloud)                                                                            | **[Quickstart](./quickstart.md)** (180.C.29.13)                                   |
| **Port the host to a new OS** — the platform-neutral permission/process/capture contract; Windows/Linux plug-in                                 | **[Host Permission Abstraction](./host-permission-abstraction.md)** (180.C.29.16) |

## Architecture Decision Records

The "why" behind the shapes the architecture doc describes:

- [ADR-0001 — Standalone Remote Gateway and Host](./adr/ADR-0001-standalone-remote-gateway-and-host.md)
- [ADR-0002 — Remote-Control Threat Model](./adr/ADR-0002-remote-control-threat-model.md)
- [ADR-0003 — Gateway Trust & E2E-Encryption Model](./adr/ADR-0003-gateway-trust-and-e2e-encryption-model.md)
- [ADR-0004 — Cross-Platform Remote Host Scope](./adr/ADR-0004-cross-platform-remote-host-scope.md)
- [ADR-0005 — MVP Release Artifact & Gates](./adr/ADR-0005-mvp-release-artifact-and-gates.md)
- [ADR-0006 — Control Room Placement](./adr/ADR-0006-control-room-placement.md)
- [ADR-0007 — QUIC/WebTransport Evaluation](./adr/ADR-0007-quic-webtransport-evaluation.md)

## Security, privacy & governance

- [Security Review](./SECURITY-REVIEW.md)
- [Privacy & Legal Review](./privacy-legal-review.md)
- [Remote-Control Mode Allowance Matrix](./remote-control-mode-allowance-matrix.md)
- [Security Regression Test Plan](./security-regression-test-plan.md)

## Cloud & networking

- [Hetzner Reference Deployment](./hetzner-reference-deployment.md)
  (180.C.25.08)
- [AWS Reference Deployment](./aws-reference-deployment.md) (180.C.25.09)
- [Tailscale / WireGuard Private Network](./tailscale-wireguard-private-network.md)
- [Deployment Smoke Test Plan](./deployment-smoke-test-plan.md)
- [Network Impairment Test Plan](./network-impairment-test-plan.md)
- [Performance Budget Test Plan](./performance-budget-test-plan.md)

## Per-tool adapters

**Blender**

- [Read-Only MVP on a Second MacBook](./blender-read-only-mvp-second-macbook.md)
- [Safe-Mutation MVP Closure](./blender-safe-mutation-mvp-closure.md)
- [Primitive Rollback & Undo](./blender-primitive-rollback-and-undo.md)
- [Production-Command Hardware Verification](./blender-production-command-hardware-verification.md)

**Unreal**

- [Plugin Architecture](./unreal-plugin-architecture.md)
- [Read-Only / Safe-Mutation MVP Closure](./unreal-readonly-safe-mutation-mvp-closure.md)

**Browser**

- [Profile Isolation](./browser-profile-isolation.md)
- [Compensating Actions](./browser-compensating-actions.md)
- [browser-use vs Direct CDP Evaluation](./browser-use-vs-direct-cdp-evaluation.md)
- [Chrome Extension Value Evaluation](./chrome-extension-value-evaluation.md)

**Desktop**

- [Desktop Compensating Actions](./desktop-compensating-actions.md)

## Adapter SDK (third-party adapters)

The published contract a third party implements to add a new tool, plus how such
an adapter is verified, signed, and distributed.

- [Adapter SDK](./adapter-sdk.md) (180.C.32.08) — the `RemoteAdapter` contract,
  writing an adapter, the conformance suite, packaging/telemetry/policy-sandbox,
  and the versioning + deprecation policy.
- [Adapter SDK Migration Guide](./adapter-sdk-migration-guide.md) — a
  file-by-file walkthrough of migrating an adapter across a contract MAJOR bump.
- [Adapter Distribution](./adapter-distribution.md) (180.C.32.09) — signing, the
  signed registry, the ad-hoc trust model, publisher trust levels, and the org
  scope-policy controls.

## Sessions, audit & operations

- [Session Timeline & Audit Bundle](./session-timeline-and-audit-bundle.md)
- [Operator Workflow — Blender + Browser MVP](./operator-workflow-blender-browser-mvp.md)
- [MVP-Alpha Operations Runbooks](./mvp-alpha-operations-runbooks.md)
- [MVP-Alpha SLOs & Error Budgets](./mvp-alpha-slos-and-error-budgets.md)
- [MVP-Alpha Soak Test Plan](./mvp-alpha-soak-test-plan.md)
- [MVP-Alpha Architecture Stability](./mvp-alpha-architecture-stability.md)
- [MVP-Alpha Demo Scenarios](./mvp-alpha-demo-scenarios.md)
- [MVP-Alpha Release Gate](./mvp-alpha-release-gate.md)
- [Operator Usability Study](./operator-usability-study.md)
- [Release Gate Alignment](./release-gate-alignment.md)
- [Final GA Release Gate](./final-ga-release-gate.md)

## Packaging, rollout & planning

- [macOS Packaging & Notarization Plan](./macos-packaging-and-notarization-plan.md)
- [macOS Hardened Runtime, Entitlements & Notarization Recovery](./macos-hardened-runtime.md)
  (180.C.26.11)
- [MDM-Friendly & Offline / Private-Studio Install & Update](./mdm-offline-install.md)
  (180.C.26.13)
- [Remote-Host Update Channel & Rollback Plan](./remote-host-update-channel-and-rollback-plan.md)
- [Stage 26 — Two Logical Units (26.A / 26.B planning note)](./stage-26-logical-units.md)
  (180.C.26.17)
- [Bridge Coexistence & Deprecation Plan](./bridge-coexistence-and-deprecation-plan.md)
- [Bridge Retirement Gate](./bridge-retirement-gate.md)
- [Compatibility Matrix](./compatibility-matrix.md)
- [Hardware Rig Inventory](./hardware-rig-inventory.md)
- [Local Cloud-Agent Simulation](./local-cloud-agent-simulation.md)
- [External Implementation Research (2026-04-21)](./external-implementation-research-2026-04-21.md)

## Code map (where the implementation lives)

| Component                       | Package                     | Path                                      |
| ------------------------------- | --------------------------- | ----------------------------------------- |
| Wire protocol (authoritative)   | `@bellona/remote-protocol`  | `libs/bellona/remote-protocol/`           |
| Gateway (the authority)         | `@bellona/remote-gateway`   | `apps/bellona/remote-gateway/`            |
| Host + adapters                 | `@bellona/remote-host`      | `apps/bellona/remote-host/`               |
| Adapter SDK (32.x)              | `@bellona/remote-adapters`  | `libs/bellona/remote-adapters/`           |
| Cross-platform host runtime     | `@bellona/host-runtime`     | `libs/bellona/host-runtime/`              |
| SDK client (29.04)              | `@oshun/bellona-client`     | `libs/bellona/client/src/remote/`         |
| CLI (`bellona remote …`, 29.06) | `@bellona/cli`              | `apps/bellona/cli/src/commands/remote.ts` |
| MCP gateway                     | `@bellona/mcp-gateway`      | `libs/bellona/mcp-gateway/`               |
| Control Room (operator UI)      | `@bellona/control-room`     | `apps/bellona/control-room/`              |
| Browser extension               | `@bellona/remote-extension` | `apps/bellona/remote-extension/`          |
| Cloud IaC                       | —                           | `deploy/bellona-remote/{hetzner,aws}/`    |

> The exhaustive per-task implementation tracker is `implementation-tracker.md`
> (very large — open with a pager).
