refactor: clarify simulation ownership

2026-07-10 11:02:11 +02:00
parent 0f7b12080e
commit ce8f71082b
29 changed files with 793 additions and 587 deletions
@@ -68,8 +68,23 @@ It also publishes the latest `ActionSelectionResult` for presentation; the UI
 does not recompute decisions. At completion it atomically pays any
 definition-backed stored-resource cost before applying the action effect. A
 late shortfall suppresses the effect and records a `task_blocked` fact.
-Further decomposition should follow measured pressure rather than splitting it
-into managers for their own sake.
+
+### VillageEconomy
+
+- owns storage and NPC-inventory transfer operations;
+- keeps `village.food` and `village.wood` synchronized as aggregate views;
+- validates and pays definition-backed completion costs;
+- emits completed transaction facts without owning their history.
+
+### SimulationEventLog
+
+- owns ordered economic and narrative event identity;
+- answers recent-history, actor-history, and consumption-rate queries;
+- restores persisted history without performing or replaying transactions.
+
+These collaborators are `RefCounted` rule services, not additional scene-tree
+managers. Further decomposition should follow measured pressure and a proven
+gameplay consumer.

 ## Active-position contract