discussion framework migration
This commit is contained in:
@@ -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,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".
|
||||
|
||||
|
||||
@@ -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,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,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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user