implements PLN-0148

crates/console/prometeu-system/src/lib.rs

@@ -29,4 +29,5 @@ pub use services::vm_runtime::{
     LatestRenderFrameStore, RenderWorkerConfig, RenderWorkerController, RenderWorkerHandoff,
     RenderWorkerHandoffWait, RenderWorkerOwnership, VirtualMachineRuntime,
 };
+pub use services::vm_session;
 pub use services::windows;

crates/console/prometeu-system/src/os/facades/sessions.rs

@@ -1,5 +1,7 @@
+use crate::os::LifecycleError;
 use crate::os::SystemOS;
 use crate::task::TaskId;
+use crate::vm_session::{VmSession, VmSessionError};
 
 pub struct SessionsFacade<'a> {
     pub(in crate::os) os: &'a mut SystemOS,
@@ -7,15 +9,27 @@ pub struct SessionsFacade<'a> {
 
 impl<'a> SessionsFacade<'a> {
     pub fn create_vm_game_task(&mut self, app_id: u32, title: impl Into<String>) -> TaskId {
+        self.try_create_vm_game_task(app_id, title)
+            .expect("newly created game task should have an associated process")
+    }
+
+    pub fn try_create_vm_game_task(
+        &mut self,
+        app_id: u32,
+        title: impl Into<String>,
+    ) -> Result<TaskId, LifecycleError> {
+        if let Some(session) = self.os.vm_sessions.resident_game_for_app(app_id) {
+            return Ok(session.task_id);
+        }
+
         let title = title.into();
         let process_id = self.os.process_manager.spawn_vm_game(app_id, title.clone());
         let task_id = self.os.task_manager.create_game_task(process_id, app_id, title);
-        self.os
-            .lifecycle()
-            .set_game_foreground_task(task_id)
-            .expect("newly created game task should have an associated process");
+        self.os.lifecycle().set_game_foreground_task(task_id)?;
+        self.create_vm_session_for_task(task_id)
+            .expect("newly created game task should create a VM session");
 
-        task_id
+        Ok(task_id)
     }
 
     pub fn create_vm_shell_task(&mut self, app_id: u32, title: impl Into<String>) -> TaskId {
@@ -26,6 +40,8 @@ impl<'a> SessionsFacade<'a> {
             .lifecycle()
             .set_shell_foreground_task(task_id)
             .expect("newly created shell task should have an associated process");
+        self.create_vm_session_for_task(task_id)
+            .expect("newly created shell task should create a VM session");
 
         task_id
     }
@@ -41,4 +57,28 @@ impl<'a> SessionsFacade<'a> {
 
         task_id
     }
+
+    pub fn vm_session_for_task(&self, task_id: TaskId) -> Option<&VmSession> {
+        self.os.vm_sessions.for_task(task_id)
+    }
+
+    pub fn resident_game_session_for_app(&self, app_id: u32) -> Option<&VmSession> {
+        self.os.vm_sessions.resident_game_for_app(app_id)
+    }
+
+    pub fn vm_session_count(&self) -> usize {
+        self.os.vm_sessions.len()
+    }
+
+    fn create_vm_session_for_task(&mut self, task_id: TaskId) -> Result<(), VmSessionError> {
+        let task = self.os.task_manager.get(task_id).expect("session task should exist").clone();
+        let process = self
+            .os
+            .process_manager
+            .get(task.process_id)
+            .expect("session process should exist")
+            .clone();
+
+        self.os.vm_sessions.create_for_task(&task, &process, "").map(|_| ())
+    }
 }

crates/console/prometeu-system/src/os/system_os.rs

@@ -6,6 +6,7 @@ use crate::os::{
 use crate::process::ProcessManager;
 use crate::services::foreground::ForegroundStack;
 use crate::services::memcard::MemcardService;
+use crate::services::vm_session::VmSessionRegistry;
 use crate::services::windows::WindowManager;
 use crate::task::TaskManager;
 use prometeu_hal::log::{LogEvent, LogLevel, LogService, LogSource};
@@ -18,6 +19,7 @@ pub struct SystemOS {
     pub(super) process_manager: ProcessManager,
     pub(super) task_manager: TaskManager,
     pub(super) foreground_stack: ForegroundStack,
+    pub(super) vm_sessions: VmSessionRegistry,
     pub(super) game_lifecycle_events: Vec<GameLifecycleEvent>,
     pub(super) window_manager: WindowManager,
     pub(super) log_service: LogService,
@@ -39,6 +41,7 @@ impl SystemOS {
             process_manager: ProcessManager::new(),
             task_manager: TaskManager::new(),
             foreground_stack: ForegroundStack::new(),
+            vm_sessions: VmSessionRegistry::new(),
             game_lifecycle_events: Vec::new(),
             window_manager: WindowManager::new(),
             log_service,
@@ -144,6 +147,7 @@ mod tests {
     use crate::process::{ProcessKind, ProcessState};
     use crate::services::foreground::{ForegroundOwner, ResidentGame, ResidentGameState};
     use crate::task::{TaskId, TaskState};
+    use prometeu_hal::app_mode::AppMode;
 
     fn process_state_for_task(os: &SystemOS, task_id: TaskId) -> ProcessState {
         let task = os.task_manager.get(task_id).expect("task should exist");
@@ -198,6 +202,63 @@ mod tests {
         );
     }
 
+    #[test]
+    fn vm_game_task_creates_vm_session() {
+        let mut os = SystemOS::new(None);
+        let task_id = os.sessions().create_vm_game_task(42, "Sector Crawl");
+
+        let sessions = os.sessions();
+        let session = sessions.vm_session_for_task(task_id).expect("VM session should exist");
+
+        assert_eq!(session.task_id, task_id);
+        assert_eq!(session.app_id, 42);
+        assert_eq!(session.title, "Sector Crawl");
+        assert_eq!(session.app_mode, AppMode::Game);
+        assert_eq!(sessions.vm_session_count(), 1);
+    }
+
+    #[test]
+    fn vm_shell_task_creates_vm_session() {
+        let mut os = SystemOS::new(None);
+        let task_id = os.sessions().create_vm_shell_task(7, "Settings");
+
+        let sessions = os.sessions();
+        let session = sessions.vm_session_for_task(task_id).expect("VM session should exist");
+
+        assert_eq!(session.task_id, task_id);
+        assert_eq!(session.app_id, 7);
+        assert_eq!(session.title, "Settings");
+        assert_eq!(session.app_mode, AppMode::Shell);
+        assert_eq!(sessions.vm_session_count(), 1);
+    }
+
+    #[test]
+    fn native_shell_task_does_not_create_vm_session() {
+        let mut os = SystemOS::new(None);
+        let task_id = os.sessions().create_native_shell_task(7, "Settings");
+
+        let sessions = os.sessions();
+
+        assert!(sessions.vm_session_for_task(task_id).is_none());
+        assert_eq!(sessions.vm_session_count(), 0);
+    }
+
+    #[test]
+    fn same_resident_game_app_reuses_existing_vm_session() {
+        let mut os = SystemOS::new(None);
+        let first = os.sessions().create_vm_game_task(42, "Sector Crawl");
+        let second = os.sessions().create_vm_game_task(42, "Sector Crawl");
+
+        let sessions = os.sessions();
+
+        assert_eq!(second, first);
+        assert_eq!(
+            sessions.resident_game_session_for_app(42).map(|session| session.task_id),
+            Some(first)
+        );
+        assert_eq!(sessions.vm_session_count(), 1);
+    }
+
     #[test]
     fn home_request_notifies_game_before_budget_suspends_it() {
         let mut os = SystemOS::new(None);

crates/console/prometeu-system/src/services/mod.rs

@@ -6,4 +6,5 @@ pub mod memcard;
 pub mod process;
 pub mod task;
 pub mod vm_runtime;
+pub mod vm_session;
 pub mod windows;

crates/console/prometeu-system/src/services/vm_session.rs

@@ -0,0 +1,195 @@
+use crate::process::{Process, ProcessId, ProcessKind};
+use crate::task::{Task, TaskId, TaskKind};
+use prometeu_hal::app_mode::AppMode;
+use prometeu_vm::VirtualMachine;
+use std::collections::HashMap;
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+pub struct VmSessionId(pub TaskId);
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum VmSessionError {
+    SessionAlreadyExists(TaskId),
+    TaskProcessMismatch { task_id: TaskId, task_process: ProcessId, process_id: ProcessId },
+    TaskKindMismatch { task_id: TaskId, task_kind: TaskKind, process_kind: ProcessKind },
+    ProcessIsNotVmBacked(ProcessId),
+}
+
+pub struct VmSession {
+    pub id: VmSessionId,
+    pub task_id: TaskId,
+    pub process_id: ProcessId,
+    pub app_id: u32,
+    pub title: String,
+    pub app_version: String,
+    pub app_mode: AppMode,
+    pub vm: VirtualMachine,
+}
+
+impl VmSession {
+    fn new(
+        task: &Task,
+        process: &Process,
+        app_mode: AppMode,
+        app_version: impl Into<String>,
+    ) -> Self {
+        Self {
+            id: VmSessionId(task.id),
+            task_id: task.id,
+            process_id: process.id,
+            app_id: task.app_id,
+            title: task.title.clone(),
+            app_version: app_version.into(),
+            app_mode,
+            vm: VirtualMachine::default(),
+        }
+    }
+}
+
+#[derive(Default)]
+pub struct VmSessionRegistry {
+    sessions: HashMap<VmSessionId, VmSession>,
+}
+
+impl VmSessionRegistry {
+    pub fn new() -> Self {
+        Self { sessions: HashMap::new() }
+    }
+
+    pub fn create_for_task(
+        &mut self,
+        task: &Task,
+        process: &Process,
+        app_version: impl Into<String>,
+    ) -> Result<VmSessionId, VmSessionError> {
+        if task.process_id != process.id {
+            return Err(VmSessionError::TaskProcessMismatch {
+                task_id: task.id,
+                task_process: task.process_id,
+                process_id: process.id,
+            });
+        }
+
+        let app_mode = app_mode_for_task_and_process(task, process)?;
+        let id = VmSessionId(task.id);
+        if self.sessions.contains_key(&id) {
+            return Err(VmSessionError::SessionAlreadyExists(task.id));
+        }
+
+        self.sessions.insert(id, VmSession::new(task, process, app_mode, app_version));
+        Ok(id)
+    }
+
+    pub fn get(&self, id: VmSessionId) -> Option<&VmSession> {
+        self.sessions.get(&id)
+    }
+
+    pub fn get_mut(&mut self, id: VmSessionId) -> Option<&mut VmSession> {
+        self.sessions.get_mut(&id)
+    }
+
+    pub fn for_task(&self, task_id: TaskId) -> Option<&VmSession> {
+        self.get(VmSessionId(task_id))
+    }
+
+    pub fn for_task_mut(&mut self, task_id: TaskId) -> Option<&mut VmSession> {
+        self.get_mut(VmSessionId(task_id))
+    }
+
+    pub fn resident_game(&self) -> Option<&VmSession> {
+        self.sessions.values().find(|session| session.app_mode == AppMode::Game)
+    }
+
+    pub fn resident_game_for_app(&self, app_id: u32) -> Option<&VmSession> {
+        self.sessions
+            .values()
+            .find(|session| session.app_mode == AppMode::Game && session.app_id == app_id)
+    }
+
+    pub fn len(&self) -> usize {
+        self.sessions.len()
+    }
+
+    pub fn is_empty(&self) -> bool {
+        self.sessions.is_empty()
+    }
+}
+
+fn app_mode_for_task_and_process(
+    task: &Task,
+    process: &Process,
+) -> Result<AppMode, VmSessionError> {
+    match (task.kind, process.kind) {
+        (TaskKind::Game, ProcessKind::VmGame) => Ok(AppMode::Game),
+        (TaskKind::Shell, ProcessKind::VmShell) => Ok(AppMode::Shell),
+        (_, ProcessKind::NativeShell) => Err(VmSessionError::ProcessIsNotVmBacked(process.id)),
+        _ => Err(VmSessionError::TaskKindMismatch {
+            task_id: task.id,
+            task_kind: task.kind,
+            process_kind: process.kind,
+        }),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::process::Process;
+    use crate::task::Task;
+
+    #[test]
+    fn creates_vm_game_session_for_vm_game_task() {
+        let process = Process::new(ProcessId(1), 42, "Stress", ProcessKind::VmGame);
+        let task = Task::new(TaskId(7), process.id, 42, "Stress", TaskKind::Game);
+        let mut registry = VmSessionRegistry::new();
+
+        let id = registry.create_for_task(&task, &process, "").expect("session should create");
+        let session = registry.get(id).expect("session should exist");
+
+        assert_eq!(session.id, VmSessionId(task.id));
+        assert_eq!(session.task_id, task.id);
+        assert_eq!(session.process_id, process.id);
+        assert_eq!(session.app_id, 42);
+        assert_eq!(session.title, "Stress");
+        assert_eq!(session.app_mode, AppMode::Game);
+    }
+
+    #[test]
+    fn creates_vm_shell_session_for_vm_shell_task() {
+        let process = Process::new(ProcessId(1), 7, "Shell", ProcessKind::VmShell);
+        let task = Task::new(TaskId(3), process.id, 7, "Shell", TaskKind::Shell);
+        let mut registry = VmSessionRegistry::new();
+
+        let id = registry.create_for_task(&task, &process, "1.0").expect("session should create");
+        let session = registry.get(id).expect("session should exist");
+
+        assert_eq!(session.app_mode, AppMode::Shell);
+        assert_eq!(session.app_version, "1.0");
+    }
+
+    #[test]
+    fn rejects_native_shell_process() {
+        let process = Process::new(ProcessId(1), 7, "Shell", ProcessKind::NativeShell);
+        let task = Task::new(TaskId(3), process.id, 7, "Shell", TaskKind::Shell);
+        let mut registry = VmSessionRegistry::new();
+
+        assert_eq!(
+            registry.create_for_task(&task, &process, ""),
+            Err(VmSessionError::ProcessIsNotVmBacked(process.id))
+        );
+    }
+
+    #[test]
+    fn finds_resident_game_by_app_id() {
+        let process = Process::new(ProcessId(1), 42, "Stress", ProcessKind::VmGame);
+        let task = Task::new(TaskId(7), process.id, 42, "Stress", TaskKind::Game);
+        let mut registry = VmSessionRegistry::new();
+        registry.create_for_task(&task, &process, "").expect("session should create");
+
+        assert_eq!(
+            registry.resident_game_for_app(42).map(|session| session.task_id),
+            Some(task.id)
+        );
+        assert_eq!(registry.resident_game_for_app(43).map(|session| session.task_id), None);
+    }
+}

discussion/index.ndjson

@@ -2,7 +2,7 @@
 {"type":"discussion","id":"DSC-0043","status":"open","ticket":"system-os-cartridge-switch-orchestrator","title":"SystemOS Cartridge Switch Orchestrator","created_at":"2026-07-03","updated_at":"2026-07-03","tags":["runtime","os","lifecycle","game","cartridge","architecture"],"agendas":[{"id":"AGD-0044","file":"AGD-0044-systemos-cartridge-switch-orchestrator.md","status":"open","created_at":"2026-07-03","updated_at":"2026-07-03"}],"decisions":[],"plans":[],"lessons":[]}
 {"type":"discussion","id":"DSC-0039","status":"abandoned","ticket":"render-pipeline-family-and-future-3d","title":"Render Pipeline Family and Future 3D","created_at":"2026-06-04","updated_at":"2026-06-04","tags":["gfx","renderer","runtime","architecture","pipeline"],"agendas":[{"id":"AGD-0039","file":"AGD-0039-render-pipeline-family-and-future-3d.md","status":"abandoned","created_at":"2026-06-04","updated_at":"2026-06-04","_override_reason":"User explicitly chose to close this agenda without a new decision because DSC-0038 already established enough architecture for future extension, and 3D is intentionally deferred."}],"decisions":[],"plans":[],"lessons":[],"_override_reason":"User explicitly chose to close this agenda without a new decision because DSC-0038 already established enough architecture for future extension, and 3D is intentionally deferred."}
 {"type":"discussion","id":"DSC-0040","status":"done","ticket":"vm-render-parallel-execution-boundary","title":"VM and Render Parallel Execution Boundary","created_at":"2026-06-04","updated_at":"2026-06-06","tags":["runtime","renderer","vm","concurrency","architecture","perf"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0048","file":"discussion/lessons/DSC-0040-vm-render-parallel-execution-boundary/LSN-0048-render-workers-need-a-closed-packet-contract.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-06"}]}
-{"type":"discussion","id":"DSC-0041","status":"in_progress","ticket":"foreground-stack-game-pause-shell-vm-backed","title":"Foreground Stack, Game Pause, and VM-Backed Shell Coexistence","created_at":"2026-06-05","updated_at":"2026-07-04","tags":["runtime","os","lifecycle","shell","game","vm","foreground","architecture"],"agendas":[{"id":"AGD-0041","file":"AGD-0041-foreground-stack-game-pause-shell-vm-backed.md","status":"accepted","created_at":"2026-06-05","updated_at":"2026-07-03"},{"id":"AGD-0046","file":"AGD-0046-vm-context-ownership-for-resident-game-and-vm-backed-shell.md","status":"accepted","created_at":"2026-07-04","updated_at":"2026-07-04"}],"decisions":[{"id":"DEC-0037","file":"DEC-0037-foreground-stack-and-game-pause-contract.md","status":"accepted","created_at":"2026-07-03","updated_at":"2026-07-03","ref_agenda":"AGD-0041"},{"id":"DEC-0038","file":"DEC-0038-vm-session-ownership-for-vm-backed-processes.md","status":"accepted","created_at":"2026-07-04","updated_at":"2026-07-04","ref_agenda":"AGD-0046"}],"plans":[{"id":"PLN-0136","file":"PLN-0136-route-desktop-home-key-outside-guest-input.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0137","file":"PLN-0137-implement-systemos-foreground-stack-state.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0138","file":"PLN-0138-specify-foreground-pause-and-home-contract.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0139","file":"PLN-0139-validate-game-home-shell-game-end-to-end.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0140","file":"PLN-0140-deliver-game-pause-resume-and-suspension.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0141","file":"PLN-0141-integrate-render-audio-and-input-pause-boundaries.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0142","file":"PLN-0142-deliver-game-lifecycle-events-to-vm-runtime.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0143","file":"PLN-0143-guarantee-cooperative-pause-budget-tick-before-suspension.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0144","file":"PLN-0144-suspend-resident-game-when-shell-takes-foreground.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0145","file":"PLN-0145-centralize-resident-game-resume-transition.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0146","file":"PLN-0146-consolidate-lifecycle-process-lookup-helpers.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0147","file":"PLN-0147-move-native-shell-profile-update-into-hub.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0148","file":"PLN-0148-introduce-vm-session-registry-and-identity.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0149","file":"PLN-0149-move-vm-runtime-state-into-vm-sessions.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0150","file":"PLN-0150-route-cartridge-loading-through-vm-sessions.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0151","file":"PLN-0151-schedule-foreground-vm-session-ticks.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0152","file":"PLN-0152-validate-game-and-vm-shell-session-coexistence.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0153","file":"PLN-0153-specify-vm-session-ownership-and-background-ready-scheduling.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]}],"lessons":[]}
+{"type":"discussion","id":"DSC-0041","status":"in_progress","ticket":"foreground-stack-game-pause-shell-vm-backed","title":"Foreground Stack, Game Pause, and VM-Backed Shell Coexistence","created_at":"2026-06-05","updated_at":"2026-07-04","tags":["runtime","os","lifecycle","shell","game","vm","foreground","architecture"],"agendas":[{"id":"AGD-0041","file":"AGD-0041-foreground-stack-game-pause-shell-vm-backed.md","status":"accepted","created_at":"2026-06-05","updated_at":"2026-07-03"},{"id":"AGD-0046","file":"AGD-0046-vm-context-ownership-for-resident-game-and-vm-backed-shell.md","status":"accepted","created_at":"2026-07-04","updated_at":"2026-07-04"}],"decisions":[{"id":"DEC-0037","file":"DEC-0037-foreground-stack-and-game-pause-contract.md","status":"accepted","created_at":"2026-07-03","updated_at":"2026-07-03","ref_agenda":"AGD-0041"},{"id":"DEC-0038","file":"DEC-0038-vm-session-ownership-for-vm-backed-processes.md","status":"accepted","created_at":"2026-07-04","updated_at":"2026-07-04","ref_agenda":"AGD-0046"}],"plans":[{"id":"PLN-0136","file":"PLN-0136-route-desktop-home-key-outside-guest-input.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0137","file":"PLN-0137-implement-systemos-foreground-stack-state.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0138","file":"PLN-0138-specify-foreground-pause-and-home-contract.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0139","file":"PLN-0139-validate-game-home-shell-game-end-to-end.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0140","file":"PLN-0140-deliver-game-pause-resume-and-suspension.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0141","file":"PLN-0141-integrate-render-audio-and-input-pause-boundaries.md","status":"done","created_at":"2026-07-03","updated_at":"2026-07-03","ref_decisions":["DEC-0037"]},{"id":"PLN-0142","file":"PLN-0142-deliver-game-lifecycle-events-to-vm-runtime.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0143","file":"PLN-0143-guarantee-cooperative-pause-budget-tick-before-suspension.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0144","file":"PLN-0144-suspend-resident-game-when-shell-takes-foreground.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0145","file":"PLN-0145-centralize-resident-game-resume-transition.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0146","file":"PLN-0146-consolidate-lifecycle-process-lookup-helpers.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0147","file":"PLN-0147-move-native-shell-profile-update-into-hub.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]},{"id":"PLN-0148","file":"PLN-0148-introduce-vm-session-registry-and-identity.md","status":"done","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0149","file":"PLN-0149-move-vm-runtime-state-into-vm-sessions.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0150","file":"PLN-0150-route-cartridge-loading-through-vm-sessions.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0151","file":"PLN-0151-schedule-foreground-vm-session-ticks.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0152","file":"PLN-0152-validate-game-and-vm-shell-session-coexistence.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]},{"id":"PLN-0153","file":"PLN-0153-specify-vm-session-ownership-and-background-ready-scheduling.md","status":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0038"]}],"lessons":[]}
 {"type":"discussion","id":"DSC-0042","status":"done","ticket":"real-render-worker-establishment","title":"Real Render Worker Establishment","created_at":"2026-06-06","updated_at":"2026-06-20","tags":["runtime","renderer","worker","concurrency","host","hal","architecture"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0049","file":"discussion/lessons/DSC-0042-real-render-worker-establishment/LSN-0049-render-worker-publication-boundary.md","status":"done","created_at":"2026-06-20","updated_at":"2026-06-20"}]}
 {"type":"discussion","id":"DSC-0038","status":"done","ticket":"render-frame-packet-boundary","title":"Logical Render Pipelines and Command Packets","created_at":"2026-05-25","updated_at":"2026-06-04","tags":["gfx","renderer","runtime","frame-composer","architecture","ui","pipeline"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0047","file":"discussion/lessons/DSC-0038-render-frame-packet-boundary/LSN-0047-typed-render-submissions-preserve-domain-boundaries.md","status":"done","created_at":"2026-06-04","updated_at":"2026-06-04"}]}
 {"type":"discussion","id":"DSC-0035","status":"done","ticket":"task-owned-shell-windows","title":"Agenda - Task-Owned Shell Windows","created_at":"2026-05-15","updated_at":"2026-05-15","tags":["runtime","os","task","window-manager","shell","lifecycle"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0044","file":"discussion/lessons/DSC-0035-task-owned-shell-windows/LSN-0044-task-window-liveness-belongs-to-the-task.md","status":"done","created_at":"2026-05-15","updated_at":"2026-05-15"}]}

discussion/workflow/plans/PLN-0148-introduce-vm-session-registry-and-identity.md

@@ -2,7 +2,7 @@
 id: PLN-0148
 ticket: foreground-stack-game-pause-shell-vm-backed
 title: Introduce VM Session Registry and Identity
-status: open
+status: done
 created: 2026-07-04
 ref_decisions: [DEC-0038]
 tags: [runtime, os, lifecycle, shell, game, vm, foreground, architecture]