From 137c7180b68f8425c42e5e56674d7dda26d4ecb4 Mon Sep 17 00:00:00 2001
From: Meta Vens <rwvens@hotmail.com>
Date: Mon, 15 Jun 2026 22:47:15 +0100
Subject: [PATCH] Route graphics settings through typed commits

---
 .voidbot/state/aetheria.cc           | Bin 139220 -> 139521 bytes
 Aetheria.State.Verify/Program.cs     |  60 +++++++++++++++++++++++++++
 Assets/Scripts/UI/MainMenu.cs        |  20 ++++-----
 docs/aetheria-perfect-machine-map.md |  11 +++--
 4 files changed, 77 insertions(+), 14 deletions(-)

diff --git a/.voidbot/state/aetheria.cc b/.voidbot/state/aetheria.cc
index 81eea9c0beb21deea15e1ef15fbc226095add488..f7ef0a864e1a85e3561e5064d1d3e5ca18a9c11a 100644
GIT binary patch
delta 1102
zcmaKsOKTKC5XYHOLe_(>nyiQ-g@RFVCvM1NlYkf{1P>C8#=v^&%+&6*&UCNSJqZy(
zBzV!23^;e+hzB2s)srZm^x#E=;6eQW3Vr~=>Y1Hf6mLy;J%07Cs{Zu4_uAXurw{DX
z@W{l_VP~vXPrq-scPAh0>)oq*ZOB|z61m}WZ*El|OMYz_waf2T4{q!n+-Pk%J$UXU
z<Dwd(h@lm+w$EJ!3bp2<r9jAKh)~Co0PROIZu!ZFS9>?BHW%pJcLT=5wMWU<PXAfp
z3Zw{DfWf@rdWB*r#if9DBrl+=={N~37GgVKWF)+QWJ8Z@1!1f-T#7Nq<mL)oUBsr0
zuuDNu(2QhAGzf;-d8kpCJZra19Vbm0M4~hg0+4|R@yz^*L$DZYa-oMdQ;K4RatRGD
zf@%j`lReW2EY`k^3_Pcp9s<3L(@`VyKsKoqq->snF!_}mAqw!Bf@U00=^-ZtHF}^W
zOfRMEhSfK<_ISZ3BQ0asH;$B>IL&EYWCKXr5<o6MS7}f_i_l9xz8W}1tPzDoqvjHk
zMc~RXBo);pc#_(rfq7n`c{OXqdi-T736=Ah375*7!=_3)9~Ug&s;=IRu(>v1VsSmu
z&TFe0K%;H7h)~T8(w_^~uB+`S&!Y+pv7O_Y?_4Z25AjTQZl;7cmrspp^b$tA$unj;
zvK9h$bbS^E|DL*>hkB)b<vc-Cuy8R0PxrjAdeS3Lto_MsrF?XH4ll(#!UCrN$f=6V
zDsNXNXC@r=HJ|GA$3AN`eP6Q6sok)=WUzT4`8{7gH9PbFNj=8gi)N^_6bfR6@P8Sc
zbSv#)dZl6QFXxLmS|4uQ)2yX#r_USK;<jfDX`~{~CJNCzednz^FT1Nu=4q|p-q~H_
z@p}4gyZt$PtT~5=#*01gNx$^jvbZ13zJyB3`|WF)XU(bA=mXf%DOKz@rA-EfuEs_h
Fe*iIGk7fV>

delta 953
zcmZXTziSjx5Xad~&`X-6NFsJqh!8Lr?-HX?iwi_UKr|kTaItx}J9qnJ_r3M~$Qhe6
zh?OAd5w=x{3RZS!s(@fAq!1*9e}t8-vwORT8rWv%eczk;er9IpOX>ST>C=06yt;U~
zx=_BbP-(n$rh8xA=S5`kd=`--k4w2`vG;3a$(=}^&W`qHN1ch=-P#J802OE8V~7TQ
zpkI)o57#+{{vFf?71*`A>m+E}HpEO|2+W#5DsHyR@4S%l=;-H$l17^C80QB%PYR=C
zs6hwP(sM!@h^%1-q0J(UL$(dF*?oYX(Uen3+YUgX@KK?f3#G?Gpf_VwhNIrdvT9H9
z*yt<Jvc@We|8q1EVkNgYy)h>{g3Mgo!g&e}DkFUqG2v^F3I-XvnnyNdhD$-GK0=3^
z0Ps;9a*rEGA5l8saruKmp-FZ0qHcxZ5oIC=l&8f!F4_Y^R3DOzY($KUbD$+T;~MB=
z<exZ0Q(Cg<=P+5V;5fjamZ4ZCGyzLXiel<Y8kViBGh_&;7ZGohj^fFieP^n>zbZ4p
z3VBN1w;uk}Kk`dPdC1f;rbV|hGN7#@Lr933pV2Fr0hQy21S4fP<df4|qe61vh6aZ2
z<h}0%DAJY;`R8#)%@c?OqWqBwk4CAEE&Zy$ch3o&<n=RWs)y@md$(pLYqdH)v|Qm$
zS<i>#Mmig-=`dzfk>Vaq(ccrx1*~X|M)wX+R+8W2?qsstaQtLv)44jCZ$qWh*fXrH
zcav|MPP4yq-+B9aY<Si?964QV(#33(k~7op!7#L(FV~5rG~>$R-lb~tWX4T~ze{~M
N<^C8eZY@_Ee*ofVQ<eY#

diff --git a/Aetheria.State.Verify/Program.cs b/Aetheria.State.Verify/Program.cs
index 286e66a15..8823ca077 100644
--- a/Aetheria.State.Verify/Program.cs
+++ b/Aetheria.State.Verify/Program.cs
@@ -12,6 +12,7 @@ RequirePackageSerializerBoundary(root);
 RequireEveRuntimeBootstrap(root);
 RequireNoRendererLocalConsole(root);
 RequireNoRendererLocalDebugPanels(root);
+RequireMainMenuSettingsCommit(root);
 
 await using var node = await AetheriaStateNode.OpenAsync(statePath, "aetheria-state-verify");
 
@@ -453,6 +454,7 @@ Console.WriteLine("Package serializer boundary: MessagePack symbols remain in na
 Console.WriteLine("Eve runtime bootstrap: operations surface mounts through UI Toolkit presenter");
 Console.WriteLine("Renderer-local console authority: deleted; UI commands flow through Eve command documents");
 Console.WriteLine("Renderer-local debug panels: obsolete uGUI field tester authority is deleted");
+Console.WriteLine("Main-menu settings authority: gameplay and graphics settings return through typed player-settings commits");
 
 static void RequireCount(AetheriaMigrationLedger ledger, string documentType, int actual)
 {
@@ -684,6 +686,64 @@ static void RequireNoRendererLocalDebugPanels(string root)
     }
 }
 
+static void RequireMainMenuSettingsCommit(string root)
+{
+    var mainMenuPath = Path.Combine(root, "Assets", "Scripts", "UI", "MainMenu.cs");
+    if (!File.Exists(mainMenuPath))
+    {
+        throw new InvalidOperationException("Cannot verify main-menu settings commit path; MainMenu.cs is missing.");
+    }
+
+    var source = File.ReadAllText(mainMenuPath);
+    if (!source.Contains("private void CommitRuntimeSettingsAndReturn()", StringComparison.Ordinal) ||
+        !source.Contains("ActionGameManager.QueueRuntimePlayerSettingsCommit();", StringComparison.Ordinal))
+    {
+        throw new InvalidOperationException(
+            "MainMenu no longer exposes a shared typed player-settings commit return path.");
+    }
+
+    var graphicsSettings = ExtractMethodBody(source, "ShowGraphicsSettings");
+    if (!graphicsSettings.Contains("CommitRuntimeSettingsAndReturn", StringComparison.Ordinal))
+    {
+        throw new InvalidOperationException(
+            "MainMenu graphics settings can return without queuing the typed player-settings commit.");
+    }
+
+    var gameplaySettings = ExtractMethodBody(source, "ShowGameplaySettings");
+    if (!gameplaySettings.Contains("CommitRuntimeSettingsAndReturn", StringComparison.Ordinal))
+    {
+        throw new InvalidOperationException(
+            "MainMenu gameplay settings can return without queuing the typed player-settings commit.");
+    }
+}
+
+static string ExtractMethodBody(string source, string methodName)
+{
+    var signature = "private void " + methodName + "()";
+    var signatureIndex = source.IndexOf(signature, StringComparison.Ordinal);
+    if (signatureIndex < 0)
+        throw new InvalidOperationException($"Cannot find MainMenu.{methodName} for settings authority verification.");
+
+    var braceIndex = source.IndexOf('{', signatureIndex);
+    if (braceIndex < 0)
+        throw new InvalidOperationException($"Cannot find MainMenu.{methodName} body for settings authority verification.");
+
+    var depth = 0;
+    for (var index = braceIndex; index < source.Length; index++)
+    {
+        if (source[index] == '{')
+            depth++;
+        else if (source[index] == '}')
+        {
+            depth--;
+            if (depth == 0)
+                return source.Substring(braceIndex, index - braceIndex + 1);
+        }
+    }
+
+    throw new InvalidOperationException($"MainMenu.{methodName} body is not balanced.");
+}
+
 static bool ContainsBehaviorValueKind(AetheriaBehaviorValue value, string kind)
 {
     return string.Equals(value.Kind, kind, StringComparison.OrdinalIgnoreCase) ||
diff --git a/Assets/Scripts/UI/MainMenu.cs b/Assets/Scripts/UI/MainMenu.cs
index 9e5fd64f3..9c624146c 100644
--- a/Assets/Scripts/UI/MainMenu.cs
+++ b/Assets/Scripts/UI/MainMenu.cs
@@ -222,12 +222,7 @@ public class MainMenu : MonoBehaviour
             () => ActionGameManager.RuntimePlayerSettings.GameplaySettings.SignificantDigits,
             i => ActionGameManager.RuntimePlayerSettings.GameplaySettings.SignificantDigits = i);
         _nextMenu.panel.AddButton("Back",
-            () =>
-            {
-                ActionGameManager.QueueRuntimePlayerSettingsCommit();
-                ShowSettings();
-                Fade(false);
-            });
+            CommitRuntimeSettingsAndReturn);
     }
 
     private void ShowGraphicsSettings()
@@ -246,11 +241,7 @@ public class MainMenu : MonoBehaviour
             () => ActionGameManager.RuntimePlayerSettings.GraphicsSettings.ShowAsteroidsInMinimap,
             b => ActionGameManager.RuntimePlayerSettings.GraphicsSettings.ShowAsteroidsInMinimap = b);
         _nextMenu.panel.AddButton("Back",
-            () =>
-            {
-                ShowSettings();
-                Fade(false);
-            });
+            CommitRuntimeSettingsAndReturn);
     }
 
     private void ShowInputSettings()
@@ -276,4 +267,11 @@ public class MainMenu : MonoBehaviour
                 Fade(false);
             });
     }
+
+    private void CommitRuntimeSettingsAndReturn()
+    {
+        ActionGameManager.QueueRuntimePlayerSettingsCommit();
+        ShowSettings();
+        Fade(false);
+    }
 }
diff --git a/docs/aetheria-perfect-machine-map.md b/docs/aetheria-perfect-machine-map.md
index 1b7e77b59..9da332346 100644
--- a/docs/aetheria-perfect-machine-map.md
+++ b/docs/aetheria-perfect-machine-map.md
@@ -87,9 +87,11 @@ legacy catalog cache, and legacy UI paths should be migration-only or deleted.
   name, tutorial flag, story-file hash cursors, gameplay formatting, graphics
   preferences, input binding overrides, and action-bar inputs. Unity's menu and
   input screens mutate `RuntimePlayerSettings` in memory and queue typed Verse
-  commits through shared player-settings commit primitives; the in-memory
-  projection is not portable state authority. Aetheria has its own remapping UI
-  that calls Unity's InputSystem at the binding/action layer; Unity's generated
+  commits through shared player-settings commit primitives. Gameplay and
+  graphics settings now return through the same main-menu commit primitive; the
+  in-memory projection is not portable state authority. Aetheria has its own
+  remapping UI that calls Unity's InputSystem at the binding/action layer;
+  Unity's generated
   `AetheriaInput` class is the edge consumer of typed binding overrides, not
   the durable owner. Binding drag/drop and action-bar remapping both route
   through named runtime input commit methods instead of writing the input
@@ -1549,6 +1551,9 @@ First Aetheria surfaces to publish:
    - Done: route input-screen binding/action-bar edits through named typed
      player-settings commit methods on the Unity runtime boundary, so the UI is
      no longer a direct writer of input binding or action-bar collections.
+   - Done: route main-menu graphics settings returns through the same typed
+     player-settings commit primitive as gameplay settings, so graphics edits
+     no longer survive only as session-local `RuntimePlayerSettings`.
    - Remaining: delete or quarantine old cache abstractions that no longer
      protect an invariant once catalog migration has a typed reader.