implements PLN-0162
This commit is contained in:
@@ -97,9 +97,11 @@ The v1 games root contract is:
|
||||
and transitions through `LoadCartridge`;
|
||||
- launch failure leaves or returns the machine to Home and records an error.
|
||||
|
||||
Game-to-game switching after a game is already active is not part of this boot
|
||||
profile. That orchestration belongs to the foreground/home and cartridge switch
|
||||
contracts.
|
||||
Game-to-game switching after a game is already active is not a boot profile.
|
||||
That orchestration belongs to the foreground/home and cartridge switch
|
||||
contracts. In that path, SystemOS owns the switch policy: selecting the same
|
||||
resident Game resumes it, while selecting a different Game performs destructive
|
||||
replacement and creates a fresh VM session for the new Game.
|
||||
|
||||
The foreground/home contract defines `Game -> Home/Shell -> same Game` after a
|
||||
Game is already running. It does not change direct `--run`, debugger direct
|
||||
@@ -108,6 +110,10 @@ are host/system controls, not guest cartridge boot APIs.
|
||||
|
||||
Direct boot creates the initial VM session for the selected cartridge. It does
|
||||
not create a reusable global VM shared by later Game or Shell cartridges.
|
||||
Direct boot and debug boot MUST NOT be treated as failed-switch recovery paths:
|
||||
load or initialization failures for direct boot may transition to the crash
|
||||
flow, while Home-driven switch failures return to Home and do not restore the
|
||||
previous Game.
|
||||
|
||||
## 5 Firmware State Relationship
|
||||
|
||||
@@ -152,6 +158,10 @@ Direct single-cartridge boot remains a separate validation path:
|
||||
cargo run --release -p prometeu-host-desktop-winit -- --run test-cartridges/stress-console
|
||||
```
|
||||
|
||||
Game switch validation should cover the Home-driven two-cartridge path, for
|
||||
example `Stress Console -> Home -> Dummy Boy`, and assert that the first Game is
|
||||
not resumable after replacement.
|
||||
|
||||
## 8 Relationship to Other Specs
|
||||
|
||||
- [`12-firmware-pos-and-prometeuhub.md`](12-firmware-pos-and-prometeuhub.md) defines the firmware state machine that consumes boot targets.
|
||||
|
||||
Reference in New Issue
Block a user