diff --git a/crates/console/prometeu-system/src/lib.rs b/crates/console/prometeu-system/src/lib.rs index c297a6fe..3baf7d46 100644 --- a/crates/console/prometeu-system/src/lib.rs +++ b/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; diff --git a/crates/console/prometeu-system/src/os/facades/sessions.rs b/crates/console/prometeu-system/src/os/facades/sessions.rs index 9dd7246a..459194d7 100644 --- a/crates/console/prometeu-system/src/os/facades/sessions.rs +++ b/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) -> 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, + ) -> Result { + 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) -> 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(|_| ()) + } } diff --git a/crates/console/prometeu-system/src/os/system_os.rs b/crates/console/prometeu-system/src/os/system_os.rs index 439e21df..2398f2a7 100644 --- a/crates/console/prometeu-system/src/os/system_os.rs +++ b/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, 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); diff --git a/crates/console/prometeu-system/src/services/mod.rs b/crates/console/prometeu-system/src/services/mod.rs index 4c32356b..aa7496a1 100644 --- a/crates/console/prometeu-system/src/services/mod.rs +++ b/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; diff --git a/crates/console/prometeu-system/src/services/vm_session.rs b/crates/console/prometeu-system/src/services/vm_session.rs new file mode 100644 index 00000000..fac91798 --- /dev/null +++ b/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, + ) -> 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, +} + +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, + ) -> Result { + 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 { + 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); + } +} diff --git a/discussion/index.ndjson b/discussion/index.ndjson index 6b424383..23009172 100644 --- a/discussion/index.ndjson +++ b/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"}]} diff --git a/discussion/workflow/plans/PLN-0148-introduce-vm-session-registry-and-identity.md b/discussion/workflow/plans/PLN-0148-introduce-vm-session-registry-and-identity.md index 06712327..fc1717db 100644 --- a/discussion/workflow/plans/PLN-0148-introduce-vm-session-registry-and-identity.md +++ b/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]