implements PLN-0123 async work lane specs
This commit is contained in:
@@ -127,7 +127,31 @@ 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
|
||||
## 8 Async Asset and IO Work Lane
|
||||
|
||||
The asset/IO async work lane is not a machine-visible event source and does not
|
||||
introduce guest callbacks. It is an implementation-side lane for asset
|
||||
IO/decode/materialization and compatible persistence IO work.
|
||||
|
||||
The lane is serial:
|
||||
|
||||
- it has at most one active job;
|
||||
- it keeps an ordered backlog;
|
||||
- it is separate from the render worker;
|
||||
- it must not create one OS thread per guest-visible asset request.
|
||||
|
||||
Asset jobs are keyed by target `bank_type/slot`. A newer request for the same
|
||||
target supersedes the older request. Superseding is an operational status and
|
||||
does not execute guest code.
|
||||
|
||||
Asset install/commit into resident banks happens on the main runtime lane at
|
||||
predictable ownership points. The async lane prepares materialized results; it
|
||||
does not publish resident graphics/audio/scene state directly.
|
||||
|
||||
FS and game persistence services may consume this lane for IO-style work, but
|
||||
public FS API shape is defined by the FS/app-home contract, not by this chapter.
|
||||
|
||||
## 9 Determinism and Best Practices
|
||||
|
||||
PROMETEU encourages:
|
||||
|
||||
@@ -142,7 +166,7 @@ PROMETEU discourages:
|
||||
- hidden timing channels;
|
||||
- ambiguous out-of-band execution.
|
||||
|
||||
## 9 Relationship to Other Specs
|
||||
## 10 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