Skip to content

RC 0.7.3 Controller Surface Matrix

This matrix defines the controller API surface that must stay green before the emulebb-v0.7.3-rc.1 RC can be tagged. It covers the release-facing API and controller integrations only; Source Exchange protocol validation is tracked by the search/server/Kad parity gates.

Proof Command

Run the focused controller-surface gate from EMULE_WORKSPACE_ROOT:

python -m emule_workspace test live-e2e --profile controller-surface --fail-fast

This profile is separate from beta-green so the short backend green run stays fast, while aMuTorrent and full controller compatibility still have a named release proof.

Surface Matrix

Native REST /api/v1

Public role: trusted local controller API for eMuleBB and aMuTorrent.

Required proof: rest-api passes OpenAPI/registry parity, safe route coverage, typed JSON success/error envelopes, destructive intent checks, and smoke stress.

qBittorrent-Compatible /api/v2

Public role: Arr download-client adapter. This is the Arr-needed qBit subset only, not a full qBittorrent Web API clone.

Required proof: rest-api, Radarr, and Sonarr prove qBit login, add, info, properties, files, category mutation, pause/resume, and delete behavior with adapter-local text/session errors.

Torznab-Compatible API

Public role: Prowlarr indexer adapter consumed directly and synced into Radarr/Sonarr.

Required proof: Prowlarr, Radarr, and Sonarr prove category-aware search, API-key handling, feed behavior, synced indexers, and redacted live-wire diagnostics.

aMuTorrent

Public role: browser UI consumer of native /api/v1; it must not drive native route aliases or adapter quirks.

Required proof: amutorrent-browser-smoke proves connection state, categories, searches, transfers, shared files/directories, uploads, transfer detail hydration, and add/delete paths.

Closeout Evidence

After each closeout run, record the current artifact paths in:

All live reports must show the workspace live-network policy: BindInterface=hide.me, empty P2P BindAddr, and P2P UPnP enabled.