docs: document economic event pipeline

docs/FOOD_STORAGE_ARCHITECTURE.md

@@ -30,6 +30,11 @@ world only when consumed.
 The village pantry has stable ID `village_pantry`. Storage and NPC inventory
 are included in versioned state and deterministic checksums.
 
+Successful extraction, deposit, withdrawal, and consumption also append
+structured economic facts. See [the economic event stream](ECONOMIC_EVENTS.md).
+Active NPCs display a small food sack while their authoritative inventory
+contains food; this is presentation derived from state, not a second inventory.
+
 ## Failure behavior
 
 Transactions apply the amount actually available:
@@ -46,13 +51,14 @@ replans on its next idle tick.
 
 This slice contains one pantry and one carried item type. It does not yet add:
 
-- visible carried props;
 - player inventory;
 - storage reservations or access capacity;
 - multiple households or ownership;
 - spoilage, item quality, weight, or stack definitions;
-- structured transaction/history events;
 - an authored StorageNode scene beyond the current pantry marker.
 
+Economic transfer events exist, but event retention, denial/depletion facts,
+witnesses, and social interpretation are deliberately deferred.
+
 Those should extend the transaction boundary rather than mutate counters
 directly.