# V3 Stage UE5.5 render worker

This is the minimal headless Unreal project used by the V10 Stage release
adapter. It renders a persisted, release-bound `/Game` level and LevelSequence;
it never authors a production scene, substitutes an engine sample, chooses a
camera, encodes media, or publishes a catalog row.

The Python commandlet accepts one absolute request path through
`V3_STAGE_RENDER_REQUEST`. Its strict v1 request binds candidate/version,
concert, export content hash, published Sequencer asset, level, exact
`CineCameraActor` label, frame range, raster size, and a private empty output
directory. It emits only contiguous `frame-NNNNNN.png` files and a SHA-256-bound
`render-manifest.json`. Missing or ambiguous assets, a mismatched display rate,
a short playback range, noncanonical output, or an absent frame fails loud.

`V3StageRenderWorkerLibrary` is a deliberately tiny editor module. Before the
first capture and before process exit it finishes asynchronous asset work,
submits material shaders required by the loaded world, waits for shader
compilation, and flushes rendering commands. The barrier prevents a commandlet
from returning black placeholder frames or crashing while cancelling live shader
jobs. Build products, fixture content, frames, and manifests are verification
artifacts and must not be committed.

`author_release_gate_fixture.py` creates a two-second, 12 fps test-only scene
from engine primitives in an isolated project copy. It proves the commandlet
against real UE5.5 serialization and Sequencer evaluation; it is not V3
inventory and carries no publication authority.

From the repository root,
`sudo V3/ue/StageRenderWorker/Scripts/verify_release_gate.sh` creates an
isolated project copy, builds the editor module, authors that fixture, runs the
complete server adapter through UE5.5 with the Mesa Lavapipe ICD, performs real
FFmpeg/FFprobe encoding and verification, and removes the copy on every exit.
`UE_ROOT`, the run-as user/group, and the Vulkan ICD may be overridden through
the environment; the script fails before mutation when any dependency is
missing.

The server-side `V3StageUnrealRenderer` in
`@oshun/v10-rail-channel-stage/release` owns the process boundary. It validates
the manifest and every PNG independently, rejects static/extra/changed output,
copies exact authorized audio bytes into its private workspace, performs real
FFmpeg encoding, requires FFprobe geometry/rate/frame-count/duration evidence,
and returns bytes to the existing immutable cook path only after all checks
agree.
