fix(ui): port live experience quality updates (#217)

Parse retail PrivateUpdatePropertyInt64 and route authoritative Total/Available Experience through both local-player projections so Attributes, the level meter, and Skills refresh together. Preserve the existing retail XP curve and right-align the Total XP value.

Close the user-confirmed item-give gate for #216 and record the named-retail/ACE/holtburger conformance evidence.

Co-Authored-By: Codex <noreply@openai.com>

src/AcDream.Core.Net/Messages/PrivateUpdatePropertyInt64.cs

@@ -0,0 +1,35 @@
+using System.Buffers.Binary;
+
+namespace AcDream.Core.Net.Messages;
+
+/// <summary>
+/// Inbound retail <c>PrivateUpdatePropertyInt64 (0x02CF)</c>: one signed
+/// 64-bit quality update for the local player. Total Experience (quality 1)
+/// and Available Experience (quality 2) use this message.
+/// </summary>
+/// <remarks>
+/// Retail: <c>CM_Qualities::DispatchUI_PrivateUpdateInt64 @ 0x006AEAD0</c>
+/// reads the sequence byte at +4, property at +5, and value at +9, then calls
+/// <c>ClientObjMaintSystem::Handle_Qualities__PrivateUpdateInt64 @ 0x00559000</c>.
+/// ACE <c>GameMessagePrivateUpdatePropertyInt64</c> and holtburger's
+/// <c>PrivateUpdatePropertyInt64Data</c> confirm the same field order.
+/// </remarks>
+public static class PrivateUpdatePropertyInt64
+{
+    public const uint Opcode = 0x02CFu;
+    public const int BodySize = 17; // opcode(4) + sequence(1) + property(4) + value(8)
+
+    public readonly record struct Parsed(uint Property, long Value);
+
+    /// <summary>Parse a complete 0x02CF body, or return null on mismatch/truncation.</summary>
+    public static Parsed? TryParse(ReadOnlySpan<byte> body)
+    {
+        if (body.Length < BodySize) return null;
+        if (BinaryPrimitives.ReadUInt32LittleEndian(body) != Opcode) return null;
+
+        const int propertyOffset = 5; // opcode + one-byte quality sequence
+        uint property = BinaryPrimitives.ReadUInt32LittleEndian(body[propertyOffset..]);
+        long value = BinaryPrimitives.ReadInt64LittleEndian(body[(propertyOffset + 4)..]);
+        return new Parsed(property, value);
+    }
+}

src/AcDream.Core.Net/ObjectTableWiring.cs

@@ -1,4 +1,5 @@
 using AcDream.Core.Items;
+using AcDream.Core.Player;
 
 namespace AcDream.Core.Net;
 
@@ -6,8 +7,9 @@ namespace AcDream.Core.Net;
 /// Wires WorldSession GameMessage-level object events into the client object
 /// table: CreateObject (0xF745) = canonical merge-upsert, DeleteObject (0xF747)
 /// = evict, PublicUpdatePropertyInt (0x02CE) = live int apply, PrivateUpdatePropertyInt
-/// (0x02CD) = player int (burden), SetStackSize (0x0197) = stack count, InventoryRemoveObject
-/// (0x0024) = inventory-view removal.
+/// (0x02CD) = player int (burden), PrivateUpdatePropertyInt64 (0x02CF) = player
+/// 64-bit qualities (experience), SetStackSize (0x0197) = stack count,
+/// InventoryRemoveObject (0x0024) = inventory-view removal.
 /// Keeps object ingestion in Core.Net (pure data, no GL) and off GameWindow.
 /// Retail: ACCObjectMaint::CreateObject / DeleteObject (the weenie_object_table side).
 /// </summary>
@@ -18,7 +20,11 @@ public static class ObjectTableWiring
     /// on <paramref name="session"/>. Call this BEFORE the render handler subscribes
     /// to EntitySpawned so the table is populated before the render path runs.
     /// </summary>
-    public static void Wire(WorldSession session, ClientObjectTable table, Func<uint>? playerGuid = null)
+    public static void Wire(
+        WorldSession session,
+        ClientObjectTable table,
+        Func<uint>? playerGuid = null,
+        LocalPlayerState? localPlayer = null)
     {
         ArgumentNullException.ThrowIfNull(session);
         ArgumentNullException.ThrowIfNull(table);
@@ -50,6 +56,14 @@ public static class ObjectTableWiring
                 table.UpdateIntProperty(playerGuid(), u.Property, u.Value);
         };
 
+        // Retail's qualities system owns one local-player value and notifies every
+        // registered panel. acdream currently exposes that value through two projections:
+        // ClientObjectTable (retained UI) and LocalPlayerState (Core consumers/fallback).
+        // Apply the authoritative 0x02CF update to both in this one wiring owner so they
+        // cannot drift after the login PlayerDescription snapshot.
+        session.PlayerInt64PropertyUpdated += u => ApplyPlayerInt64PropertyUpdate(
+            table, localPlayer, playerGuid?.Invoke() ?? 0u, u);
+
         // B-Wire: SetStackSize (0x0197) — update the object's stack count + value.
         session.StackSizeUpdated += u => table.UpdateStackSize(u.Guid, u.StackSize, u.Value);
 
@@ -58,6 +72,18 @@ public static class ObjectTableWiring
         session.InventoryObjectRemoved += guid => table.Remove(guid);
     }
 
+    /// <summary>Shared application step kept internal for byte-to-state conformance tests.</summary>
+    internal static void ApplyPlayerInt64PropertyUpdate(
+        ClientObjectTable table,
+        LocalPlayerState? localPlayer,
+        uint playerGuid,
+        WorldSession.PlayerInt64PropertyUpdate update)
+    {
+        if (playerGuid != 0u)
+            table.UpdateInt64Property(playerGuid, update.Property, update.Value);
+        localPlayer?.OnInt64PropertyUpdate(update.Property, update.Value);
+    }
+
     /// <summary>Translate the wire spawn into the table's merge patch.</summary>
     public static WeenieData ToWeenieData(WorldSession.EntitySpawn s) => new(
         Guid: s.Guid,

src/AcDream.Core.Net/WorldSession.cs

@@ -294,6 +294,15 @@ public sealed class WorldSession : IDisposable
     /// PropertyInt updated on the player. B-Wire routes EncumbranceVal (5) to the burden bar.</summary>
     public event Action<PlayerIntPropertyUpdate>? PlayerIntPropertyUpdated;
 
+    /// <summary>Payload for <see cref="PlayerInt64PropertyUpdated"/>: a signed
+    /// 64-bit quality change on the player's own object. Retail sends Total XP
+    /// (1) and Available XP (2) through PrivateUpdatePropertyInt64 (0x02CF).</summary>
+    public readonly record struct PlayerInt64PropertyUpdate(uint Property, long Value);
+
+    /// <summary>Fires after parsing retail PrivateUpdatePropertyInt64 (0x02CF).
+    /// The wire carries no guid because the local player is implicit.</summary>
+    public event Action<PlayerInt64PropertyUpdate>? PlayerInt64PropertyUpdated;
+
     /// <summary>Payload for <see cref="StackSizeUpdated"/>: SetStackSize (0x0197) — a stack's
     /// count + value after a merge / split.</summary>
     public readonly record struct StackSizeUpdate(uint Guid, int StackSize, int Value);
@@ -1078,6 +1087,15 @@ public sealed class WorldSession : IDisposable
                     PlayerIntPropertyUpdated?.Invoke(
                         new PlayerIntPropertyUpdate(p.Value.Property, p.Value.Value));
             }
+            else if (op == PrivateUpdatePropertyInt64.Opcode)
+            {
+                // Retail CM_Qualities::DispatchUI_PrivateUpdateInt64 @ 0x006AEAD0.
+                // TotalExperience (1) and AvailableExperience (2) both arrive here.
+                var p = PrivateUpdatePropertyInt64.TryParse(body);
+                if (p is not null)
+                    PlayerInt64PropertyUpdated?.Invoke(
+                        new PlayerInt64PropertyUpdate(p.Value.Property, p.Value.Value));
+            }
             else if (op == SetStackSize.Opcode)
             {
                 var p = SetStackSize.TryParse(body);