docs: record player-citizen loop, care needs, regrowth, and seasons

2026-08-11 00:46:00 +02:00
parent e51cde57be
commit e359e5253a
7 changed files with 150 additions and 38 deletions
@@ -41,6 +41,10 @@ would otherwise obscure that lifecycle:
  advancement, deterministic routine selection, loaded binding, feed
  reservations, exact NPC pantry-to-inventory-to-animal delivery, and the
  bounded direct player pantry-to-animal operation;
+- `simulation/player/player_citizen_system.gd` owns the persisted
+  `PlayerStateRecord` (hunger, energy, carried inventory), deterministic
+  needs advancement, and the player's carry/deposit/eat transactions through
+  the same storage and event contract as NPCs;
 - `simulation/events/SimulationEventLog.gd` owns ordered event identity,
  history queries, and rate calculations;
 - `simulation/knowledge/EventKnowledgeSystem.gd` owns per-NPC references to