feat(app): add background project lifecycle saves (#25)

Run manual project saves and recovery checkpoints from captured snapshots without blocking the UI.

Unify new, open, close, and quit transitions behind Save / Discard / Cancel, and stream large electrophysiology and AFM payloads in bounded chunks.

Author: nmrtist

crates/app/src/main.rs

@@ -412,7 +412,7 @@ mod tests {
     #[test]
     fn automated_exit_bypasses_dirty_project_prompt() {
         let mut app = PlotxApp::new_with_settings(plotx_core::settings::Settings::default());
-        app.doc.dirty = true;
+        app.mark_document_dirty();
         let ctx = egui::Context::default();
 
         let output = ctx.run_ui(egui::RawInput::default(), |ui| {

crates/app/src/shot.rs

@@ -136,7 +136,7 @@ pub(crate) fn render_inline_panel_note_editor(app: &mut PlotxApp, screen: egui::
             .and_then(|object| object.plot_mut())
         {
             plot.panel.user_note = buffer.clone();
-            app.doc.dirty = true;
+            app.mark_document_dirty();
         }
     }
 

crates/app/src/ui/canvas/board_notes.rs

@@ -275,7 +275,7 @@ pub(crate) fn apply_plot_pan(
     .clamp_to(plot_object.viewport.full_y);
     plot_object.viewport.auto_y = false;
     plot_object.apply_viewport();
-    app.doc.dirty = true;
+    app.mark_document_dirty();
 }
 
 pub(crate) fn commit_data_pan(app: &mut PlotxApp) {
@@ -650,7 +650,7 @@ pub(crate) fn zoom_plot_viewport(
         plot_object.viewport.zoom_y(anchor, scale);
     }
     plot_object.apply_viewport();
-    app.doc.dirty = true;
+    app.mark_document_dirty();
     ui.ctx()
         .request_repaint_after(std::time::Duration::from_millis(200));
 }

crates/app/src/ui/canvas/navigation.rs

@@ -98,7 +98,7 @@ pub(crate) fn handle_panel_label_interactions(
                     (drag.before.position[0] + delta.x).clamp(0.0, max_x),
                     (drag.before.position[1] + delta.y).clamp(0.0, max_y),
                 ];
-                app.doc.dirty = true;
+                app.mark_document_dirty();
             }
         }
         if primary_released || !primary_down {

crates/app/src/ui/canvas/panel_notes.rs

@@ -196,7 +196,7 @@ pub(crate) fn handle_phase_drag(
                 if let Some(ppm) = preview
                     && app.doc.datasets[di].repivot_ppm(axis, ppm)
                 {
-                    app.doc.dirty = true;
+                    app.mark_document_dirty();
                 }
                 finish_phase_drag(app);
             }

crates/app/src/ui/canvas/phase.rs

@@ -2,7 +2,9 @@
 //! descriptions makes the live catalog easy to inspect and keeps source files
 //! within the repository size limit.
 
-use plotx_core::state::{CommandPaletteState, LineShapeKind, PlotxApp, Tool, ToolGroup};
+use plotx_core::state::{
+    CommandPaletteState, LineShapeKind, PlotxApp, ProjectTransition, Tool, ToolGroup,
+};
 
 use super::clipboard_table::ClipboardTablePaste;
 use super::commands::{self, CommandId};
@@ -26,7 +28,13 @@ pub fn execute(
         return;
     }
     match id {
+        CommandId::NewProject => {
+            app.request_project_transition(ProjectTransition::New);
+        }
         CommandId::OpenProject => super::file_dialogs::open_project(app),
+        CommandId::CloseProject => {
+            app.request_project_transition(ProjectTransition::Close);
+        }
         CommandId::OpenFile => super::file_dialogs::open_file(app),
         CommandId::OpenFolder => super::file_dialogs::open_folder(app),
         CommandId::RunBatchWorkflow => super::batch_workflow::AutomationUi::request_open(ctx),

crates/app/src/ui/command_exec.rs

@@ -37,7 +37,9 @@ pub enum Applicability {
 
 #[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub enum CommandId {
+    NewProject,
     OpenProject,
+    CloseProject,
     OpenFile,
     OpenFolder,
     RunBatchWorkflow,
@@ -175,7 +177,9 @@ pub struct CommandDescriptor {
 
 pub fn catalog(app: &PlotxApp) -> Vec<CommandDescriptor> {
     let mut ids = vec![
+        CommandId::NewProject,
         CommandId::OpenProject,
+        CommandId::CloseProject,
         CommandId::OpenFile,
         CommandId::OpenFolder,
         CommandId::RunBatchWorkflow,
@@ -368,6 +372,18 @@ pub fn describe(app: &PlotxApp, id: CommandId) -> CommandDescriptor {
     // command can never be blocked by one requirement while explaining another.
     // `and_then` reports the first unmet requirement and skips the rest.
     let gate: Result<(), &'static str> = match id {
+        CommandId::CloseProject => requires(
+            app.session.project_present
+                || app.doc.project_path.is_some()
+                || !app.doc.datasets.is_empty()
+                || !app.doc.canvases.is_empty()
+                || app.doc.dirty,
+            "There is no project to close.",
+        ),
+        CommandId::SaveProject => requires(
+            !app.session.ui.project_save_in_progress,
+            "Wait for the current project save to finish.",
+        ),
         CommandId::OpenRecent(index) => requires(
             index < app.session.recent_files.len(),
             "Open a file or project to fill the recent list.",

crates/app/src/ui/commands.rs

@@ -39,7 +39,9 @@ pub(super) fn command_identity(
 ) -> (String, Option<&'static str>, Option<bool>) {
     let plain = |text: &str, glyph| (text.to_owned(), glyph, None);
     match id {
+        CommandId::NewProject => plain("New Project", Some(icon::FILE_PLUS)),
         CommandId::OpenProject => plain("Open Project…", Some(icon::FOLDER_OPEN)),
+        CommandId::CloseProject => plain("Close Project", Some(icon::X)),
         CommandId::OpenFile => plain("Open File…", Some(icon::FILE)),
         CommandId::OpenFolder => plain("Open Folder…", Some(icon::FOLDER)),
         CommandId::RunBatchWorkflow => plain("Automation…", Some(icon::PLAY)),
@@ -329,7 +331,9 @@ fn recent_label(app: &PlotxApp, index: usize) -> String {
 
 fn simple_stable_id(id: CommandId) -> &'static str {
     match id {
+        CommandId::NewProject => "file.new_project",
         CommandId::OpenProject => "file.open_project",
+        CommandId::CloseProject => "file.close_project",
         CommandId::OpenFile => "file.open_file",
         CommandId::OpenFolder => "file.open_folder",
         CommandId::RunBatchWorkflow => "tools.automation",

crates/app/src/ui/commands/identity.rs

@@ -147,6 +147,8 @@ fn ribbon_groups(app: &PlotxApp) -> Vec<(WorkflowTab, Vec<&'static str>)> {
 
 #[test]
 fn stable_ids_cover_static_and_dynamic_commands() {
+    assert_eq!(CommandId::NewProject.stable_id(), "file.new_project");
+    assert_eq!(CommandId::CloseProject.stable_id(), "file.close_project");
     assert_eq!(CommandId::SaveProject.stable_id(), "file.save");
     assert_eq!(CommandId::ArrangeGrid(2, 3).stable_id(), "arrange.grid.2x3");
     assert_eq!(CommandId::Tool(Tool::LineFit).stable_id(), "tool.line_fit");