---
id: PLN-0120
ticket: real-render-worker-establishment
title: Update Real Render Worker Specs
status: done
created: 2026-06-15
completed:
ref_decisions: [DEC-0033]
tags: [runtime, renderer, worker, specs]
---

## Briefing

`DEC-0033` requires canonical runtime specs to document the real worker contract after implementation publishes the behavior.

## Decisions de Origem

- `DEC-0033`: Real Render Worker Contract.

## Alvo

Update English canonical specs to describe `OwnedRgba8888Frame`, worker handoff, host presentation split, read-only bank access, shutdown, errors, and telemetry.

## Escopo

- Update GFX/render specs.
- Update portability/host presentation specs.
- Update host ABI/syscall specs if worker behavior affects published runtime surfaces.
- Ensure no spec says the worker owns native window present.

## Fora de Escopo

- No new architecture beyond `DEC-0033`.
- No lesson writing.
- No implementation changes except documentation.

## Plano de Execucao

### Step 1 - Update GFX spec

**What:** Document worker frame publication.
**How:** Add `OwnedRgba8888Frame`, RGBA8888 `Vec<u32>` semantics, latest published frame, and repeat behavior.
**File(s):** `docs/specs/runtime/04-gfx-peripheral.md`.

### Step 2 - Update portability spec

**What:** Document worker/host split.
**How:** State that worker produces owned RGBA8888 frames and host event loop performs native upload/present.
**File(s):** `docs/specs/runtime/11-portability-and-cross-platform-execution.md`.

### Step 3 - Update concurrency/events spec if needed

**What:** Document handoff and shutdown behavior.
**How:** Add single-slot latest-wins, bounded shutdown, and non-blocking producer semantics where concurrency is specified.
**File(s):** `docs/specs/runtime/09-events-and-concurrency.md` or adjacent runtime spec.

### Step 4 - Update README/index references

**What:** Keep spec map discoverable.
**How:** Add any needed cross-reference to worker/render sections.
**File(s):** `docs/specs/runtime/README.md`.

## Criterios de Aceite

- [ ] Specs define `OwnedRgba8888Frame`.
- [ ] Specs state worker does not own native window present.
- [ ] Specs state producer does not block on worker rasterization/present.
- [ ] Specs document read-only bank access by id.
- [ ] Specs document bounded shutdown and typed error expectations.

## Tests / Validacao

- `rg "OwnedRgba8888Frame|latest-wins|shutdown|read-only" docs/specs/runtime -n`
- `discussion validate`

## Riscos

- Updating specs before implementation may accidentally publish intent as completed behavior; execute after code plans that establish the behavior.
- Spec wording must remain English and normative.