From 30eda5c82edc1103588829f4d29139f3bc61ff8d Mon Sep 17 00:00:00 2001
From: Meta Vens <rwvens@hotmail.com>
Date: Tue, 16 Jun 2026 00:40:04 +0100
Subject: [PATCH] Route inventory renames through checkpoints

---
 .voidbot/state/aetheria.cc                   | Bin 142118 -> 142144 bytes
 Aetheria.State.Verify/Program.cs             |  33 +++++++++++++++++++
 Assets/Scripts/Gameplay/ActionGameManager.cs |   9 +++++
 Assets/Scripts/UI/Menu/InventoryPanel.cs     |   2 +-
 docs/aetheria-perfect-machine-map.md         |   7 +++-
 5 files changed, 49 insertions(+), 2 deletions(-)

diff --git a/.voidbot/state/aetheria.cc b/.voidbot/state/aetheria.cc
index fc078b7cc12edd871eebbd30b2c89940ab34d7fb..5d18650cac3af76d058c06050a49392a537b0840 100644
GIT binary patch
delta 1124
zcmaJ=O=uHA6lOM6Q-46QRkT8%UaXj=N&nKcB9z*e9I7=^6s?5m?j*Z*Gn4MjR&y%S
zi{LSZJrxn5f?m8u@lboHHw7<+;!Ok(o;-Ngw?9dvh^O6s``$O-_q}g6cH-}L;;%Ne
z_JPdkP&S$APkYBeJ5k%#9ydxu8NYO<=EhW`lu3nM@wRTQE4F%}t$v}6JiT@P#yC?Z
zb1Vvua1}Ga;>(OH;Zy-1ma2loI4yfW=gHv8=Un6GEal7wF2EMN#2lbfS|u)_U|6zZ
z(<(D2gX!c|T4rEa4%3xgO+wxW^9$4#B?&sUZ5Y>;CHOSfXDFwLmYfjfvZX=<A0Pqu
zO-naBpzJEDn1mK^@8exEuo7{VoK~bM6!@pe<a5QiMC{%7*K7ma>A75sJY8_*2wS4S
zGPQUTt^_Orn}TC-4lD@^%;F``U4^4Mw&F=hx|#qffbuF7UFAAO)&fieJ)nfEo58Hf
z^u>y>xNooY1psn%k<kKcxUNjJzhpuQdHeqLO)fLg(FV#5psq57gS+rPy(As8+c!<d
z_uwPxmJz)Or-jR0E&+>-ReV)cf?^L;pT#SvMi;h?OF@;MD3H!WlY9H}9u-K>DCN*f
zLZV8lBVnJPjyu5EgqBvQGLtVT*O6qN73Es}TY>D;4y-<NSaElxmP(yE5_0Pevcx<=
zN#gkB8G#xj($SAiN-lceDfu#cJ<pb0Tu3u<A-^y`VLrwiwjif_C`Cp&gXT<_(g3@*
z^?IQ8<kI1DQxhoOwz#iE7mgwSq<}7YzvfAox2BW)*!15?{8s`o1_ms-%tccooftoF
z${=6U>5y;~_#p2R{ugyGy-qs4bw+yP;r$-Y);};Z_NMvi9qramH?DPdFu2xUu3OuT
uIx^YXkJ!nYi0$`!K@(BuNUA^Vd<)vcW^FjA)$g3uw%QMd=Z&OOw|@i2Y>yuR

delta 1185
zcmaJ>Pe>F|7-v=s?HZER!LN%b>Ds30S`dhc8U$sQA?EgW=G&c@Gw<1ZZ+6=*5*?#M
z2+i4xK@ixbty6jE-X+0f5JYt97If)*Gdqh&b=&>To8R~S{>=NZ*R{RZwX>Z&Rw!OP
zH<~X_Oe{ZhdNx1io@7XIG(lv?!!|ORAYGk(xl`XC4|X;OJDsiDXP2hX_^3DoB_o3#
z_)!pmD}@)ihS#`hz|DCuvRVz|pDWJT#;<u%Lt&(9Tw?+Q5E23@s;Ho@xIqmw!q8j!
zIpUc<NaJyZt_d1>m^YyCeuUcSl$qW#KFzQCFhx_Pm}MbeWr7iHep-ehHyK@jw$`Fu
z35THWbJvG3GRzJqEl^e5i{IXHMmMaM(m^ey2O|y8bTm1n^DhhvP4o7Dv{hNT+VIo_
z!?@5O0}rBE!imZ#8R#L<5>h>&c^C!EE}br6e<%#?iyJ_$q8lm2MHLj+Yk9auUROA|
z<;of=5=aKt>C`>)MrWLv*i0)ht$9_1<U3T93~9$9C`Sg$N-~egc$NvU#6O)#I6>(k
zMJnq8mG=2M&8cy$$Gcn3@zVazl8=G{h+N<9*X9_pwpk}t$O1r*8+tqhYl!RC9HtXl
zNq#h13LB{nY&~ENJ4>etES8*s37bdDH7KJiL&}H=n5kJf44LpiN2<bH%)ey9^`%<C
zir#F#DLF@S@r|<crFU+Dx<cJKY)X9Hb$WXh3NirIa3EdUmi9|)7{7kyT<*UzO(q3g
zpv^%lPyeOfOvk@hoYT)eXW=e2_F&mE|I@CuOZKmZTQy`06+0O-e6V@L=_mBmbH1*w
zw#$}&LbQ0G;lHD)O$Hf7S!s2_CU)2naFK}O-MZ5gH_;jBYF!T(n%~g5^sYPmTiE>6
zak6zUOcuuNy%4*7x%U}#zSz1vj>fZ)lNmfZmYn<yxkni^R<KYrI+NS&Ze!!ie*kgx
Bt|<Tj

diff --git a/Aetheria.State.Verify/Program.cs b/Aetheria.State.Verify/Program.cs
index f7971ff3c..b1007f4c4 100644
--- a/Aetheria.State.Verify/Program.cs
+++ b/Aetheria.State.Verify/Program.cs
@@ -16,6 +16,7 @@ RequireMainMenuSettingsCommit(root);
 RequirePropertiesPanelReadOnlyInspector(root);
 RequireRuntimeSimulationTuningCommits(root);
 RequireHullConductivityCommitAuthority(root);
+RequireInventoryEntityRenameCommitAuthority(root);
 
 await using var node = await AetheriaStateNode.OpenAsync(statePath, "aetheria-state-verify");
 
@@ -461,6 +462,7 @@ Console.WriteLine("Main-menu settings authority: gameplay and graphics settings
 Console.WriteLine("PropertiesPanel inspector authority: reflection inspection is read-only display");
 Console.WriteLine("Runtime simulation tuning authority: UI writes flow through gameplay checkpoint commits");
 Console.WriteLine("Hull conductivity authority: inventory UI toggles flow through gameplay checkpoint commits");
+Console.WriteLine("Inventory entity rename authority: UI rename flows through gameplay checkpoint commits");
 
 static void RequireCount(AetheriaMigrationLedger ledger, string documentType, int actual)
 {
@@ -838,6 +840,37 @@ static void RequireHullConductivityCommitAuthority(string root)
     }
 }
 
+static void RequireInventoryEntityRenameCommitAuthority(string root)
+{
+    var actionGameManagerPath = Path.Combine(root, "Assets", "Scripts", "Gameplay", "ActionGameManager.cs");
+    var actionGameManager = File.Exists(actionGameManagerPath)
+        ? File.ReadAllText(actionGameManagerPath)
+        : throw new InvalidOperationException("Cannot verify inventory entity rename authority; ActionGameManager.cs is missing.");
+
+    if (!actionGameManager.Contains("CommitEntityName", StringComparison.Ordinal) ||
+        !actionGameManager.Contains("QueueRunCheckpoint(\"entity-name\")", StringComparison.Ordinal))
+    {
+        throw new InvalidOperationException(
+            "Entity rename no longer has a gameplay-owned checkpoint commit primitive.");
+    }
+
+    var inventoryPanelPath = Path.Combine(root, "Assets", "Scripts", "UI", "Menu", "InventoryPanel.cs");
+    var inventoryPanel = File.Exists(inventoryPanelPath)
+        ? File.ReadAllText(inventoryPanelPath)
+        : throw new InvalidOperationException("Cannot verify inventory entity rename authority; InventoryPanel.cs is missing.");
+
+    if (inventoryPanel.Contains("_displayedEntity.Name =", StringComparison.Ordinal))
+    {
+        throw new InvalidOperationException(
+            "InventoryPanel still renames entities directly instead of using the gameplay checkpoint commit primitive.");
+    }
+
+    if (!inventoryPanel.Contains("GameManager.CommitEntityName", StringComparison.Ordinal))
+    {
+        throw new InvalidOperationException("InventoryPanel no longer routes entity rename through ActionGameManager.");
+    }
+}
+
 static string ExtractMethodBody(string source, string methodName)
 {
     var signature = "private void " + methodName + "()";
diff --git a/Assets/Scripts/Gameplay/ActionGameManager.cs b/Assets/Scripts/Gameplay/ActionGameManager.cs
index 8ff34889c..34585bae8 100644
--- a/Assets/Scripts/Gameplay/ActionGameManager.cs
+++ b/Assets/Scripts/Gameplay/ActionGameManager.cs
@@ -1415,6 +1415,15 @@ public class ActionGameManager : MonoBehaviour
         QueueRunCheckpoint("entity-override-shutdown");
     }
 
+    public void CommitEntityName(Entity entity, string name)
+    {
+        if (entity == null)
+            return;
+
+        entity.Name = name ?? "";
+        QueueRunCheckpoint("entity-name");
+    }
+
     public void CommitEquippedItemOverrideShutdown(EquippedItem item, bool enabled)
     {
         if (item?.EquippableItem == null)
diff --git a/Assets/Scripts/UI/Menu/InventoryPanel.cs b/Assets/Scripts/UI/Menu/InventoryPanel.cs
index e60558d34..6a87542f7 100644
--- a/Assets/Scripts/UI/Menu/InventoryPanel.cs
+++ b/Assets/Scripts/UI/Menu/InventoryPanel.cs
@@ -141,7 +141,7 @@ public class InventoryPanel : MonoBehaviour, IPointerClickHandler
                 Dialog.AddField("Name", () => entityName, s => entityName = s);
                 Dialog.Show(() =>
                 {
-                    _displayedEntity.Name = entityName;
+                    GameManager.CommitEntityName(_displayedEntity, entityName);
                     Title.text = _displayedEntity.Name;
                 });
                 Dialog.MoveToCursor();
diff --git a/docs/aetheria-perfect-machine-map.md b/docs/aetheria-perfect-machine-map.md
index 26535674b..aca08c753 100644
--- a/docs/aetheria-perfect-machine-map.md
+++ b/docs/aetheria-perfect-machine-map.md
@@ -1380,6 +1380,10 @@ First Aetheria surfaces to publish:
      `ActionGameManager.CommitHullConductivityToggle`; the gameplay owner mutates
      `Entity.HullConductivity` and queues the typed run checkpoint that already
      projects `hull_conductivity_x` and `hull_conductivity_y` grids.
+   - Done: route inventory entity renames through
+     `ActionGameManager.CommitEntityName`. `InventoryPanel` may collect the name
+     in a dialog, but gameplay owns the entity `Name` mutation and queues the
+     typed entity snapshot checkpoint.
    - Replace the next concrete uGUI screen with an Eve-owned surface.
    - Move the staged packages into the Eve repo once its worktree is clean, then
      import them back into Aetheria from Eve instead of carrying a local copy.
@@ -1698,7 +1702,8 @@ tuning controls may remain temporarily on uGUI only when they delegate to
 gameplay-owned commit methods that queue typed checkpoint state; direct UI
 mutation of entity/item/behavior settings is obsolete authority. Hull
 conductivity changes follow the same rule: UI requests the toggle, gameplay owns
-the grid mutation and checkpoint. Any
+the grid mutation and checkpoint. Entity renames follow the same rule: UI
+collects text, gameplay owns the name mutation and checkpoint. Any
 predicate that still needs legacy DTO objects must earn that dependency by
 using behavior objects or simulation-only methods that typed facets do not yet
 expose.