implements PLN-0147

crates/console/prometeu-firmware/src/firmware/firmware_step_shell_running.rs

@@ -74,26 +74,11 @@ impl ShellRunningStep {
             }
         };
 
-        let action = match process_kind {
+        let outcome = match process_kind {
             ProcessKind::VmShell => {
-                let outcome =
+                ctx.hub.update_shell_profile(ctx.os, ctx.vm, ctx.signals, ctx.platform)
-                    ctx.hub.update_shell_profile(ctx.os, ctx.vm, ctx.signals, ctx.platform);
-
-                if let Some(report) = outcome.crash {
-                    let _ = ctx.os.lifecycle().crash_task(self.task_id, Some(&report));
-                    return Some(FirmwareState::AppCrashes(AppCrashesStep { report }));
-                }
-
-                outcome.action
-            }
-            ProcessKind::NativeShell => {
-                let mut action = ctx.hub.gui_update(ctx.os, ctx.platform);
-                if ctx.platform.input().pad().start().down {
-                    action = Some(SystemProfileAction::CloseShell);
-                }
-                ctx.hub.render(ctx.os, ctx.platform);
-                action
             }
+            ProcessKind::NativeShell => ctx.hub.update_native_shell_profile(ctx.os, ctx.platform),
             ProcessKind::VmGame => {
                 let report = CrashReport::VmPanic {
                     message: format!(
@@ -106,7 +91,12 @@ impl ShellRunningStep {
             }
         };
 
-        if action == Some(SystemProfileAction::CloseShell) {
+        if let Some(report) = outcome.crash {
+            let _ = ctx.os.lifecycle().crash_task(self.task_id, Some(&report));
+            return Some(FirmwareState::AppCrashes(AppCrashesStep { report }));
+        }
+
+        if outcome.action == Some(SystemProfileAction::CloseShell) {
             self.close_current_shell(ctx);
             return Some(FirmwareState::HubHome(HubHomeStep));
         }

crates/console/prometeu-system/src/programs/prometeu_hub/prometeu_hub.rs

@@ -193,6 +193,22 @@ impl PrometeuHub {
 
         SystemProfileUpdate { crash, action }
     }
+
+    pub fn update_native_shell_profile(
+        &mut self,
+        os: &mut SystemOS,
+        platform: &mut dyn RuntimePlatform,
+    ) -> SystemProfileUpdate {
+        let mut action = self.gui_update(os, platform);
+
+        if os.windows().focused_window().is_some() && platform.input().pad().start().down {
+            action = Some(SystemProfileAction::CloseShell);
+        }
+
+        self.render(os, platform);
+
+        SystemProfileUpdate { crash: None, action }
+    }
 }
 
 fn action_for_click(
@@ -398,6 +414,34 @@ fn draw_buffer_text(commands: &mut Vec<GfxUiCommand>, x: i32, y: i32, text: &str
 #[cfg(test)]
 mod tests {
     use super::*;
+    use crate::task::TaskId;
+    use crate::windows::WindowOwner;
+    use prometeu_drivers::TestPlatform;
+    use prometeu_hal::{InputSignals, RuntimePlatform};
+
+    fn focused_native_shell_fixture(
+        signals: &InputSignals,
+    ) -> (PrometeuHub, SystemOS, TestPlatform) {
+        let hub = PrometeuHub::new();
+        let mut os = SystemOS::new(None);
+        let mut platform = TestPlatform::new();
+
+        {
+            let mut windows = os.windows();
+            let id = windows.add_window(
+                "ShellA".to_string(),
+                WindowOwner::Task(TaskId(7)),
+                SHELL_FRAME,
+                Color::GREEN,
+            );
+            windows.set_focus(id);
+        }
+
+        platform.input_mut().pad_mut().begin_frame(signals);
+        platform.input_mut().touch_mut().begin_frame(signals);
+
+        (hub, os, platform)
+    }
 
     #[test]
     fn shell_a_button_click_emits_launch_action() {
@@ -518,4 +562,35 @@ mod tests {
             CLOSE_BUTTON.y + CLOSE_BUTTON.h - 1
         ));
     }
+
+    #[test]
+    fn native_shell_profile_start_close_does_not_tick_vm() {
+        let signals = InputSignals { start_signal: true, ..Default::default() };
+        let (mut hub, mut os, mut platform) = focused_native_shell_fixture(&signals);
+
+        let tick_index_before_update = os.vm().tick_index();
+        let outcome = hub.update_native_shell_profile(&mut os, &mut platform);
+
+        assert_eq!(outcome.action, Some(SystemProfileAction::CloseShell));
+        assert!(outcome.crash.is_none());
+        assert_eq!(os.vm().tick_index(), tick_index_before_update);
+    }
+
+    #[test]
+    fn native_shell_profile_close_button_does_not_tick_vm() {
+        let signals = InputSignals {
+            f_signal: true,
+            x_pos: CLOSE_BUTTON.x,
+            y_pos: CLOSE_BUTTON.y,
+            ..Default::default()
+        };
+        let (mut hub, mut os, mut platform) = focused_native_shell_fixture(&signals);
+
+        let tick_index_before_update = os.vm().tick_index();
+        let outcome = hub.update_native_shell_profile(&mut os, &mut platform);
+
+        assert_eq!(outcome.action, Some(SystemProfileAction::CloseShell));
+        assert!(outcome.crash.is_none());
+        assert_eq!(os.vm().tick_index(), tick_index_before_update);
+    }
 }

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"}],"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"}],"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":"open","created_at":"2026-07-04","updated_at":"2026-07-04","ref_decisions":["DEC-0037"]}],"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"}],"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"}],"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"]}],"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-0147-move-native-shell-profile-update-into-hub.md

@@ -2,7 +2,7 @@
 id: PLN-0147
 ticket: foreground-stack-game-pause-shell-vm-backed
 title: Move Native Shell Profile Update Into Hub
-status: open
+status: done
 created: 2026-07-04
 ref_decisions: [DEC-0037]
 tags: [runtime, os, lifecycle, shell, game, vm, foreground, architecture]