diff --git a/src/AcDream.Core/Items/ItemRepository.cs b/src/AcDream.Core/Items/ItemRepository.cs
index d070a651..a993f336 100644
--- a/src/AcDream.Core/Items/ItemRepository.cs
+++ b/src/AcDream.Core/Items/ItemRepository.cs
@@ -141,7 +141,9 @@ public sealed class ItemRepository
     /// fuller data carried by its CreateObject (icon, name, type). Returns false if the
     /// item isn't tracked yet — phase 1 enriches existing items only; full
     /// CreateObject ingestion of newly-acquired items is the inventory phase.
-    /// Raises ItemPropertiesUpdated on success so bound widgets (the toolbar) re-render.
+    /// Raises ItemPropertiesUpdated whenever the item is found (matching the
+    /// UpdateProperties convention — it fires on found regardless of whether a field
+    /// actually changed) so bound widgets (the toolbar) re-render.
     /// </summary>
     public bool EnrichItem(uint objectId, uint iconId, string name, ItemType type)
     {