80 lines
2.6 KiB
Markdown
80 lines
2.6 KiB
Markdown
---
|
|
id: PLN-0120
|
|
ticket: real-render-worker-establishment
|
|
title: Update Real Render Worker Specs
|
|
status: open
|
|
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.
|