Intrepid/prometeu-runtime
Intrepid/prometeu-runtime
4
0
Fork 0
Code Pull Requests Activity
prometeu-runtime/discussion/workflow/plans/PLN-0120-update-real-render-worker-specs.md

2.6 KiB
Raw Blame History

id ticket title status created completed ref_decisions tags
PLN-0120 real-render-worker-establishment Update Real Render Worker Specs open 2026-06-15
DEC-0033
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.