discussion framework migration

This commit is contained in:
2026-03-27 04:40:34 +00:00
parent c7e4d7398f
commit a27ad45f91
41 changed files with 48 additions and 48 deletions
+2 -2
View File
@@ -7,8 +7,8 @@ It exists to explain the fantasy handheld's mental model, influences, tradeoffs,
## Authority
- `docs/runtime/learn/` is not a canonical source of technical contract.
- The machine's normative surfaces live in [`../specs/`](../specs/README.md).
- The VM/runtime's internal invariants live in [`../virtual-machine/ARCHITECTURE.md`](../virtual-machine/ARCHITECTURE.md).
- The machine's normative surfaces live in [`../specs/`](../../specs/README.md).
- The VM/runtime's internal invariants live in [`../virtual-machine/ARCHITECTURE.md`](../../vm-arch/ARCHITECTURE.md).
## Reading Order
@@ -3,8 +3,8 @@
Status: historical snapshot in `learn`, not normative.
Current normative anchors:
- [`../specs/15-asset-management.md`](../specs/15-asset-management.md)
- [`../specs/16a-syscall-policies.md`](../specs/16a-syscall-policies.md)
- [`../specs/15-asset-management.md`](../../specs/15-asset-management.md)
- [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md)
- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md)
## Status
@@ -3,8 +3,8 @@
Status: historical snapshot in `learn`, not normative.
Current normative anchors:
- [`../specs/05-audio-peripheral.md`](../specs/05-audio-peripheral.md)
- [`../specs/16a-syscall-policies.md`](../specs/16a-syscall-policies.md)
- [`../specs/05-audio-peripheral.md`](../../specs/05-audio-peripheral.md)
- [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md)
- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md)
## Status
@@ -2,9 +2,9 @@
Status: pedagogical / historical
Normative anchors:
- [`../specs/13-cartridge.md`](../specs/13-cartridge.md)
- [`../specs/12-firmware-pos-and-prometeuhub.md`](../specs/12-firmware-pos-and-prometeuhub.md)
- [`../specs/14-boot-profiles.md`](../specs/14-boot-profiles.md)
- [`../specs/13-cartridge.md`](../../specs/13-cartridge.md)
- [`../specs/12-firmware-pos-and-prometeuhub.md`](../../specs/12-firmware-pos-and-prometeuhub.md)
- [`../specs/14-boot-profiles.md`](../../specs/14-boot-profiles.md)
This document records the historical rationale behind removing `entrypoint` from the cartridge manifest and moving cartridge boot authority into the executable artifact itself.
@@ -3,9 +3,9 @@
Status: historical snapshot in `learn`, not normative.
Current normative anchors:
- [`../specs/08-save-memory-and-memcard.md`](../specs/08-save-memory-and-memcard.md)
- [`../specs/16-host-abi-and-syscalls.md`](../specs/16-host-abi-and-syscalls.md)
- [`../specs/16a-syscall-policies.md`](../specs/16a-syscall-policies.md)
- [`../specs/08-save-memory-and-memcard.md`](../../specs/08-save-memory-and-memcard.md)
- [`../specs/16-host-abi-and-syscalls.md`](../../specs/16-host-abi-and-syscalls.md)
- [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md)
- [`mental-model-save-memory-and-memcard.md`](mental-model-save-memory-and-memcard.md)
- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md)
@@ -3,8 +3,8 @@
Status: historical snapshot in `learn`, not normative.
Current normative anchors:
- [`../specs/04-gfx-peripheral.md`](../specs/04-gfx-peripheral.md)
- [`../specs/16a-syscall-policies.md`](../specs/16a-syscall-policies.md)
- [`../specs/04-gfx-peripheral.md`](../../specs/04-gfx-peripheral.md)
- [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md)
- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md)
## Status
@@ -3,9 +3,9 @@
Status: pedagogical
Companion specs:
- [`../specs/13-cartridge.md`](../specs/13-cartridge.md)
- [`../specs/15-asset-management.md`](../specs/15-asset-management.md)
- [`../specs/04-gfx-peripheral.md`](../specs/04-gfx-peripheral.md)
- [`../specs/13-cartridge.md`](../../specs/13-cartridge.md)
- [`../specs/15-asset-management.md`](../../specs/15-asset-management.md)
- [`../specs/04-gfx-peripheral.md`](../../specs/04-gfx-peripheral.md)
Origin decisions:
+1 -1
View File
@@ -1,7 +1,7 @@
# Audio Mental Model
Status: pedagogical
Companion spec: [`../specs/05-audio-peripheral.md`](../specs/05-audio-peripheral.md)
Companion spec: [`../specs/05-audio-peripheral.md`](../../specs/05-audio-peripheral.md)
The right mental model for audio in PROMETEU is an active peripheral with a budget, not "automatic sound".
+2 -2
View File
@@ -1,9 +1,9 @@
# GFX Mental Model
Status: pedagogical
Companion spec: [`../specs/04-gfx-peripheral.md`](../specs/04-gfx-peripheral.md)
Companion spec: [`../specs/04-gfx-peripheral.md`](../../specs/04-gfx-peripheral.md)
Related asset spec: [`../specs/15-asset-management.md`](../specs/15-asset-management.md)
Related asset spec: [`../specs/15-asset-management.md`](../../specs/15-asset-management.md)
PROMETEU treats graphics as an explicit peripheral, not as a modern GPU.
+1 -1
View File
@@ -1,7 +1,7 @@
# Input Mental Model
Status: pedagogical
Companion spec: [`../specs/06-input-peripheral.md`](../specs/06-input-peripheral.md)
Companion spec: [`../specs/06-input-peripheral.md`](../../specs/06-input-peripheral.md)
PROMETEU treats input as sampled state, not as an asynchronous event.
@@ -1,7 +1,7 @@
# Observability and Debugging
Status: pedagogical
Companion spec: [`../specs/10-debug-inspection-and-profiling.md`](../specs/10-debug-inspection-and-profiling.md)
Companion spec: [`../specs/10-debug-inspection-and-profiling.md`](../../specs/10-debug-inspection-and-profiling.md)
PROMETEU was designed to be observable.
@@ -1,7 +1,7 @@
# Portability and Cross-Platform Execution
Status: pedagogical
Companion spec: [`../specs/11-portability-and-cross-platform-execution.md`](../specs/11-portability-and-cross-platform-execution.md)
Companion spec: [`../specs/11-portability-and-cross-platform-execution.md`](../../specs/11-portability-and-cross-platform-execution.md)
PROMETEU treats portability as an architectural property of the machine, not as an after-the-fact adaptation.
@@ -1,7 +1,7 @@
# Save Memory and MEMCARD
Status: pedagogical
Companion spec: [`../specs/08-save-memory-and-memcard.md`](../specs/08-save-memory-and-memcard.md)
Companion spec: [`../specs/08-save-memory-and-memcard.md`](../../specs/08-save-memory-and-memcard.md)
Historical snapshot: [`historical-game-memcard-slots-surface-and-semantics.md`](historical-game-memcard-slots-surface-and-semantics.md)
PROMETEU treats persistence as explicit hardware, not as invisible save behavior.
@@ -3,11 +3,11 @@
Status: pedagogical
Companion specs:
- [`../specs/16a-syscall-policies.md`](../specs/16a-syscall-policies.md)
- [`../specs/04-gfx-peripheral.md`](../specs/04-gfx-peripheral.md)
- [`../specs/05-audio-peripheral.md`](../specs/05-audio-peripheral.md)
- [`../specs/08-save-memory-and-memcard.md`](../specs/08-save-memory-and-memcard.md)
- [`../specs/15-asset-management.md`](../specs/15-asset-management.md)
- [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md)
- [`../specs/04-gfx-peripheral.md`](../../specs/04-gfx-peripheral.md)
- [`../specs/05-audio-peripheral.md`](../../specs/05-audio-peripheral.md)
- [`../specs/08-save-memory-and-memcard.md`](../../specs/08-save-memory-and-memcard.md)
- [`../specs/15-asset-management.md`](../../specs/15-asset-management.md)
PROMETEU uses a status-first model so the host/runtime boundary does not hide operational errors as silence, improper `Trap`, or accidental `Panic`.
@@ -1,7 +1,7 @@
# Time Model and Cycles
Status: pedagogical
Companion spec: [`../specs/01-time-model-and-cycles.md`](../specs/01-time-model-and-cycles.md)
Companion spec: [`../specs/01-time-model-and-cycles.md`](../../specs/01-time-model-and-cycles.md)
PROMETEU treats time as an explicit part of the machine.
+1 -1
View File
@@ -1,7 +1,7 @@
# Touch Mental Model
Status: pedagogical
Companion spec: [`../specs/07-touch-peripheral.md`](../specs/07-touch-peripheral.md)
Companion spec: [`../specs/07-touch-peripheral.md`](../../specs/07-touch-peripheral.md)
PROMETEU uses TOUCH as an absolute, deterministic pointer, not as a gesture-rich surface.