Release v1.2.3: .effectgraph zip format, FTA, Ctrl+S accelerators, unsaved-changes guard

Author: Spruill-1

.github/copilot-instructions.md

@@ -110,7 +110,7 @@ The tone mapping system (`Rendering/ToneMapper.h/.cpp`) and color correction are
 - **Effect registry**: Singleton with 40+ built-in D2D effects across 9 categories. Case-insensitive name lookup.
 - **ShaderLab effects library**: 20+ built-in effects in `Effects/ShaderLabEffects.h/.cpp` (Analysis + Color Processing + Source/Generator + Parameter / Clock / Numeric Expression). Embedded HLSL with shared color math. Auto-compiled at first use.
 - **MCP server**: 23-tool JSON-RPC 2.0 server on port 47808 for AI agent integration. Routes in `MainWindow.McpRoutes.cpp`.
-- **Versioning**: `Version.h` defines app version (1.2.2) and graph format version (2). Both stored in saved graphs. Forward compatibility check on load.
+- **Versioning**: `Version.h` defines app version (1.2.3) and graph format version (2). Both stored in saved graphs. Forward compatibility check on load.
 - **Dirty-gated render loop**: `DispatcherQueueTimer` at 16ms (~60 FPS). Skips evaluate when no nodes changed. Analysis readback only on dirty frames.
 - **Ctrl+Enter** compiles shader from the editor TextBox.
 

App.xaml.cpp

@@ -128,6 +128,33 @@ namespace winrt::ShaderLab::implementation
             impl->SetAutoStartMcp(true);
         impl->SetDevicePreference(devicePref);
 
+        // File activation: when the user double-clicks a .effectgraph
+        // file in Explorer, the OS launches us with the file path on
+        // the command line. We just scan for it here -- proper
+        // Microsoft.Windows.AppLifecycle activation routing isn't
+        // worth the WinAppSDK reunion glue for a single argument.
+        {
+            int argc = 0;
+            wchar_t** argv = ::CommandLineToArgvW(GetCommandLineW(), &argc);
+            if (argv)
+            {
+                for (int i = 1; i < argc; ++i)
+                {
+                    std::wstring a = argv[i];
+                    // Skip our own flags.
+                    if (a.starts_with(L"--")) continue;
+                    auto lower = a;
+                    std::transform(lower.begin(), lower.end(), lower.begin(), ::towlower);
+                    if (lower.ends_with(L".effectgraph"))
+                    {
+                        impl->SetPendingOpenPath(a);
+                        break;
+                    }
+                }
+                ::LocalFree(argv);
+            }
+        }
+
         window = mw;
         window.Activate();
     }

CHANGELOG.md

@@ -3,6 +3,24 @@
 All notable changes to ShaderLab will be documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [1.2.3] - 2026-05-03
+
+### Added
+- **`.effectgraph` file format**: native graph container. Standard ZIP archive (no compression, no third-party libraries — Win32 `CreateFile` + a small in-house store-only writer in `Rendering/EffectGraphFile.cpp`) holding `graph.json` plus a reserved empty `media/` folder for future media embedding (so a shared graph will eventually open with no broken file paths).
+- **File type association**: `.effectgraph` is registered in `Package.appxmanifest`. Double-clicking a file in Explorer launches ShaderLab with the graph already loaded. `App::OnLaunched` parses the command line for the file path and hands it to `MainWindow::SetPendingOpenPath` to load after rendering is initialized.
+- **Save / Save As keyboard accelerators**: `Ctrl+S` saves over the last picked path (or prompts on first save). `Ctrl+Shift+S` always shows the picker. `Ctrl+O` opens. The Save Graph button advertises both shortcuts in its tooltip.
+- **Unsaved-changes guard**: `MainWindow` tracks `m_unsavedChanges` and shows a `Save / Discard / Cancel` `ContentDialog` when the window is closed via `AppWindow.Closing`. Title bar shows the file name with a `*` suffix while edits are unsaved.
+
+### Changed
+- `MainWindow::SaveGraphAsync` now overwrites the previously-picked path silently; previously every save reopened the picker.
+- App version string in the toolbar now derives from `Version.h` instead of a hard-coded `v1.1.0`.
+
+### Removed
+- Legacy `.json` graph save / load support. `.effectgraph` is the only graph container; existing `.json` files from pre-1.2.3 builds will no longer open. There were no released users at the time of the cutover.
+
+### Fixed
+- Toolbar version text was stuck on `v1.1.0` regardless of the actual app version.
+
 ## [1.2.2] - 2026-05-02
 
 ### Added

MainWindow.xaml

@@ -29,13 +29,20 @@
               BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}"
               BorderThickness="0,0,0,1">
             <StackPanel Orientation="Horizontal" Spacing="4">
-                <Button x:Name="SaveGraphButton" ToolTipService.ToolTip="Save Graph">
+                <Button x:Name="SaveGraphButton" ToolTipService.ToolTip="Save Graph (Ctrl+S, Ctrl+Shift+S = Save As)">
+                    <Button.KeyboardAccelerators>
+                        <KeyboardAccelerator Modifiers="Control" Key="S" Invoked="OnSaveAccelerator" />
+                        <KeyboardAccelerator Modifiers="Control,Shift" Key="S" Invoked="OnSaveAsAccelerator" />
+                    </Button.KeyboardAccelerators>
                     <StackPanel Orientation="Horizontal" Spacing="6">
                         <FontIcon Glyph="&#xE74E;" FontSize="14" />
                         <TextBlock Text="Save Graph" />
                     </StackPanel>
                 </Button>
-                <Button x:Name="LoadGraphButton" ToolTipService.ToolTip="Load Graph">
+                <Button x:Name="LoadGraphButton" ToolTipService.ToolTip="Load Graph (Ctrl+O)">
+                    <Button.KeyboardAccelerators>
+                        <KeyboardAccelerator Modifiers="Control" Key="O" />
+                    </Button.KeyboardAccelerators>
                     <StackPanel Orientation="Horizontal" Spacing="6">
                         <FontIcon Glyph="&#xE8E5;" FontSize="14" />
                         <TextBlock Text="Load Graph" />