implements PLN-0120
This commit is contained in:
@@ -100,7 +100,34 @@ Important properties:
|
||||
- no execution occurs outside the frame loop;
|
||||
- frame structure remains observable for host tooling and host-owned certification.
|
||||
|
||||
## 7 Determinism and Best Practices
|
||||
## 7 Render Worker Concurrency
|
||||
|
||||
The render worker is not a machine-visible event source and does not introduce
|
||||
guest callbacks. It is an implementation-side consumer of closed render
|
||||
submissions.
|
||||
|
||||
The render worker handoff uses single-slot latest-wins semantics:
|
||||
|
||||
- a producer publishes at most one pending owned `RenderSubmission`;
|
||||
- a newer submission replaces an older unconsumed pending submission;
|
||||
- replacement is counted as telemetry;
|
||||
- the producer does not wait for worker rasterization or host present;
|
||||
- the worker takes ownership of the submission it consumes.
|
||||
|
||||
The worker publishes `OwnedRgba8888Frame` values. Each published frame owns its
|
||||
RGBA8888 pixel vector and carries frame and ownership metadata. Repeating a
|
||||
frame reuses the latest published owned frame and does not execute guest code
|
||||
or recompose the frame.
|
||||
|
||||
Render resources reachable from a submission are resolved through read-only
|
||||
ID-based access. The worker MUST NOT hold mutable VM state, mutable `Hardware`,
|
||||
mutable `Gfx`, or a live mutable `FrameComposer` as its cross-thread contract.
|
||||
|
||||
Shutdown is explicit and bounded. A shutdown request wakes a waiting worker,
|
||||
causes pending work that will not be consumed to be discarded, and reports a
|
||||
typed failure if the worker cannot join within the configured timeout.
|
||||
|
||||
## 8 Determinism and Best Practices
|
||||
|
||||
PROMETEU encourages:
|
||||
|
||||
@@ -115,7 +142,7 @@ PROMETEU discourages:
|
||||
- hidden timing channels;
|
||||
- ambiguous out-of-band execution.
|
||||
|
||||
## 8 Relationship to Other Specs
|
||||
## 9 Relationship to Other Specs
|
||||
|
||||
- [`09a-coroutines-and-cooperative-scheduling.md`](09a-coroutines-and-cooperative-scheduling.md) defines coroutine lifecycle and scheduling behavior.
|
||||
- [`10-debug-inspection-and-profiling.md`](10-debug-inspection-and-profiling.md) defines observability and diagnostics surfaces.
|
||||
|
||||
Reference in New Issue
Block a user