discussion framework migration

discussion/index.ndjson

@@ -0,0 +1,2 @@
+{"type":"meta","next_id":{"DSC":2,"AGD":1,"DEC":1,"PLN":1,"LSN":19,"CLSN":1}}
+{"type":"discussion","id":"DSC-0001","status":"done","ticket":"legacy-runtime-learn-import","title":"Import legacy runtime learn into discussion lessons","created_at":"2026-03-27","updated_at":"2026-03-27","tags":["migration","tech-debt"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0001","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0001-prometeu-learn-index.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0002","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0002-historical-asset-status-first-fault-and-return-contract.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0003","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0003-historical-audio-status-first-fault-and-return-contract.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0004","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0004-historical-cartridge-boot-protocol-and-manifest-authority.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0005","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0005-historical-game-memcard-slots-surface-and-semantics.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0006","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0006-historical-gfx-status-first-fault-and-return-contract.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0007","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0007-historical-retired-fault-and-input-decisions.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0008","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0008-historical-vm-core-and-assets.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0009","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0009-mental-model-asset-management.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0010","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0010-mental-model-audio.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0011","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0011-mental-model-gfx.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0012","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0012-mental-model-input.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0013","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0013-mental-model-observability-and-debugging.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0014","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0014-mental-model-portability-and-cross-platform.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0015","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0015-mental-model-save-memory-and-memcard.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0016","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0016-mental-model-status-first-and-fault-thinking.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0017","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0017-mental-model-time-and-cycles.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0018","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0018-mental-model-touch.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"}]}

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0001-prometeu-learn-index.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0001
+ticket: legacy-runtime-learn-import
+title: PROMETEU Learn
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # PROMETEU Learn
 
 This area contains pedagogical material about the PROMETEU machine.
@@ -6,7 +14,7 @@ It exists to explain the fantasy handheld's mental model, influences, tradeoffs,
 
 ## Authority
 
-- `docs/runtime/learn/` is not a canonical source of technical contract.
+- `discussion/lessons/` 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`](../../vm-arch/ARCHITECTURE.md).
 
@@ -14,38 +22,38 @@ It exists to explain the fantasy handheld's mental model, influences, tradeoffs,
 
 If someone is entering the machine model now, the most useful order is:
 
-1. [`mental-model-time-and-cycles.md`](mental-model-time-and-cycles.md)
+1. [`mental-model-time-and-cycles.md`](LSN-0017-mental-model-time-and-cycles.md)
-2. [`mental-model-portability-and-cross-platform.md`](mental-model-portability-and-cross-platform.md)
+2. [`mental-model-portability-and-cross-platform.md`](LSN-0014-mental-model-portability-and-cross-platform.md)
-3. [`mental-model-observability-and-debugging.md`](mental-model-observability-and-debugging.md)
+3. [`mental-model-observability-and-debugging.md`](LSN-0013-mental-model-observability-and-debugging.md)
-4. [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md)
+4. [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md)
 5. then the peripherals and specific domains
 
 ## Core Mental Models
 
-- [`mental-model-time-and-cycles.md`](mental-model-time-and-cycles.md)
+- [`mental-model-time-and-cycles.md`](LSN-0017-mental-model-time-and-cycles.md)
-- [`mental-model-portability-and-cross-platform.md`](mental-model-portability-and-cross-platform.md)
+- [`mental-model-portability-and-cross-platform.md`](LSN-0014-mental-model-portability-and-cross-platform.md)
-- [`mental-model-observability-and-debugging.md`](mental-model-observability-and-debugging.md)
+- [`mental-model-observability-and-debugging.md`](LSN-0013-mental-model-observability-and-debugging.md)
-- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md)
+- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md)
 
 ## Peripheral Mental Models
 
-- [`mental-model-gfx.md`](mental-model-gfx.md)
+- [`mental-model-gfx.md`](LSN-0011-mental-model-gfx.md)
-- [`mental-model-audio.md`](mental-model-audio.md)
+- [`mental-model-audio.md`](LSN-0010-mental-model-audio.md)
-- [`mental-model-asset-management.md`](mental-model-asset-management.md)
+- [`mental-model-asset-management.md`](LSN-0009-mental-model-asset-management.md)
-- [`mental-model-input.md`](mental-model-input.md)
+- [`mental-model-input.md`](LSN-0012-mental-model-input.md)
-- [`mental-model-touch.md`](mental-model-touch.md)
+- [`mental-model-touch.md`](LSN-0018-mental-model-touch.md)
-- [`mental-model-save-memory-and-memcard.md`](mental-model-save-memory-and-memcard.md)
+- [`mental-model-save-memory-and-memcard.md`](LSN-0015-mental-model-save-memory-and-memcard.md)
 
 ## Historical Snapshots
 
 These files preserve the rationale of decisions already absorbed by specs and/or implementation. They are useful for context, but they should not be read as the primary current contract.
 
-- [`historical-gfx-status-first-fault-and-return-contract.md`](historical-gfx-status-first-fault-and-return-contract.md)
+- [`historical-gfx-status-first-fault-and-return-contract.md`](LSN-0006-historical-gfx-status-first-fault-and-return-contract.md)
-- [`historical-audio-status-first-fault-and-return-contract.md`](historical-audio-status-first-fault-and-return-contract.md)
+- [`historical-audio-status-first-fault-and-return-contract.md`](LSN-0003-historical-audio-status-first-fault-and-return-contract.md)
-- [`historical-asset-status-first-fault-and-return-contract.md`](historical-asset-status-first-fault-and-return-contract.md)
+- [`historical-asset-status-first-fault-and-return-contract.md`](LSN-0002-historical-asset-status-first-fault-and-return-contract.md)
-- [`historical-cartridge-boot-protocol-and-manifest-authority.md`](historical-cartridge-boot-protocol-and-manifest-authority.md)
+- [`historical-cartridge-boot-protocol-and-manifest-authority.md`](LSN-0004-historical-cartridge-boot-protocol-and-manifest-authority.md)
-- [`historical-game-memcard-slots-surface-and-semantics.md`](historical-game-memcard-slots-surface-and-semantics.md)
+- [`historical-game-memcard-slots-surface-and-semantics.md`](LSN-0005-historical-game-memcard-slots-surface-and-semantics.md)
-- [`historical-retired-fault-and-input-decisions.md`](historical-retired-fault-and-input-decisions.md)
+- [`historical-retired-fault-and-input-decisions.md`](LSN-0007-historical-retired-fault-and-input-decisions.md)
 
 ## Naming Convention
 

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0002-historical-asset-status-first-fault-and-return-contract.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0002
+ticket: legacy-runtime-learn-import
+title: Historical Snapshot - Asset Status-First Fault and Return Contract
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Historical Snapshot - Asset Status-First Fault and Return Contract
 
 Status: historical snapshot in `learn`, not normative.
@@ -5,7 +13,7 @@ Current normative anchors:
 
 - [`../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)
+- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md)
 
 ## Status
 

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0003-historical-audio-status-first-fault-and-return-contract.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0003
+ticket: legacy-runtime-learn-import
+title: Historical Snapshot - Audio Status-First Fault and Return Contract
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Historical Snapshot - Audio Status-First Fault and Return Contract
 
 Status: historical snapshot in `learn`, not normative.
@@ -5,7 +13,7 @@ Current normative anchors:
 
 - [`../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)
+- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md)
 
 ## Status
 

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0004-historical-cartridge-boot-protocol-and-manifest-authority.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0004
+ticket: legacy-runtime-learn-import
+title: Historical Cartridge Boot Protocol and Manifest Authority
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Historical Cartridge Boot Protocol and Manifest Authority
 
 Status: pedagogical / historical

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0005-historical-game-memcard-slots-surface-and-semantics.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0005
+ticket: legacy-runtime-learn-import
+title: Historical Snapshot - Game Memcard Slots Surface and Semantics
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Historical Snapshot - Game Memcard Slots Surface and Semantics
 
 Status: historical snapshot in `learn`, not normative.
@@ -6,8 +14,8 @@ 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)
-- [`mental-model-save-memory-and-memcard.md`](mental-model-save-memory-and-memcard.md)
+- [`mental-model-save-memory-and-memcard.md`](LSN-0015-mental-model-save-memory-and-memcard.md)
-- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md)
+- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md)
 
 ## Status
 

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0006-historical-gfx-status-first-fault-and-return-contract.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0006
+ticket: legacy-runtime-learn-import
+title: Historical Snapshot - GFX Status-First Fault and Return Contract
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Historical Snapshot - GFX Status-First Fault and Return Contract
 
 Status: historical snapshot in `learn`, not normative.
@@ -5,7 +13,7 @@ Current normative anchors:
 
 - [`../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)
+- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md)
 
 ## Status
 

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0007-historical-retired-fault-and-input-decisions.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0007
+ticket: legacy-runtime-learn-import
+title: Retired Decisions 004-005 (Historical Notes)
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Retired Decisions 004-005 (Historical Notes)
 
 This file keeps historical rationale from decisions that were retired after being absorbed by specs.

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0008-historical-vm-core-and-assets.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0008
+ticket: legacy-runtime-learn-import
+title: Historical VM Core and Assets (Retired Decisions)
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Historical VM Core and Assets (Retired Decisions)
 
 This document consolidates the historical rationale and mental models from retired decisions regarding VM-owned stateful core, byte transfer protocol, filesystem fault policies, and asset management.

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0009-mental-model-asset-management.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0009
+ticket: legacy-runtime-learn-import
+title: Asset Management Mental Model
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Asset Management Mental Model
 
 Status: pedagogical

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0010-mental-model-audio.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0010
+ticket: legacy-runtime-learn-import
+title: Audio Mental Model
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Audio Mental Model
 
 Status: pedagogical

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0011-mental-model-gfx.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0011
+ticket: legacy-runtime-learn-import
+title: GFX Mental Model
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # GFX Mental Model
 
 Status: pedagogical

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0012-mental-model-input.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0012
+ticket: legacy-runtime-learn-import
+title: Input Mental Model
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Input Mental Model
 
 Status: pedagogical

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0013-mental-model-observability-and-debugging.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0013
+ticket: legacy-runtime-learn-import
+title: Observability and Debugging
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Observability and Debugging
 
 Status: pedagogical

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0014-mental-model-portability-and-cross-platform.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0014
+ticket: legacy-runtime-learn-import
+title: Portability and Cross-Platform Execution
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Portability and Cross-Platform Execution
 
 Status: pedagogical

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0015-mental-model-save-memory-and-memcard.md

@@ -1,8 +1,16 @@
+---
+id: LSN-0015
+ticket: legacy-runtime-learn-import
+title: Save Memory and MEMCARD
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Save Memory and MEMCARD
 
 Status: pedagogical
 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)
+Historical snapshot: [`historical-game-memcard-slots-surface-and-semantics.md`](LSN-0005-historical-game-memcard-slots-surface-and-semantics.md)
 
 PROMETEU treats persistence as explicit hardware, not as invisible save behavior.
 

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0016-mental-model-status-first-and-fault-thinking.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0016
+ticket: legacy-runtime-learn-import
+title: Status-First and Fault Thinking
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Status-First and Fault Thinking
 
 Status: pedagogical
@@ -146,10 +154,10 @@ Signs that the contract is still weak:
 
 This guide consolidates the intuition that first appeared in these historical snapshots:
 
-- [`historical-gfx-status-first-fault-and-return-contract.md`](historical-gfx-status-first-fault-and-return-contract.md)
+- [`historical-gfx-status-first-fault-and-return-contract.md`](LSN-0006-historical-gfx-status-first-fault-and-return-contract.md)
-- [`historical-audio-status-first-fault-and-return-contract.md`](historical-audio-status-first-fault-and-return-contract.md)
+- [`historical-audio-status-first-fault-and-return-contract.md`](LSN-0003-historical-audio-status-first-fault-and-return-contract.md)
-- [`historical-asset-status-first-fault-and-return-contract.md`](historical-asset-status-first-fault-and-return-contract.md)
+- [`historical-asset-status-first-fault-and-return-contract.md`](LSN-0002-historical-asset-status-first-fault-and-return-contract.md)
-- [`historical-game-memcard-slots-surface-and-semantics.md`](historical-game-memcard-slots-surface-and-semantics.md)
+- [`historical-game-memcard-slots-surface-and-semantics.md`](LSN-0005-historical-game-memcard-slots-surface-and-semantics.md)
-- [`historical-retired-fault-and-input-decisions.md`](historical-retired-fault-and-input-decisions.md)
+- [`historical-retired-fault-and-input-decisions.md`](LSN-0007-historical-retired-fault-and-input-decisions.md)
 
 Use the snapshots for historical context. Use the specs for the current normative contract.

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0017-mental-model-time-and-cycles.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0017
+ticket: legacy-runtime-learn-import
+title: Time Model and Cycles
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Time Model and Cycles
 
 Status: pedagogical

discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0018-mental-model-touch.md

@@ -1,3 +1,11 @@
+---
+id: LSN-0018
+ticket: legacy-runtime-learn-import
+title: Touch Mental Model
+created: 2026-03-27
+tags: [migration, tech-debt]
+---
+
 # Touch Mental Model
 
 Status: pedagogical