docs: document simulation readability layer

docs/PROJECT_CONTEXT.md

@@ -342,8 +342,11 @@ A small village panel displays:
 - knowledge;
 - starving NPC count;
 - selected village modifiers.
+- a Tab-cycled NPC inspector with profession, needs, task state, destination,
+  decision reason, and utility scores.
 
-Most deeper reasoning is currently visible only through verbose debug output.
+NPC name/profession labels, definition-driven colors and props, and the
+carried-food visual make active simulation state readable in the world.
 
 ## Runtime architecture
 
@@ -518,7 +521,8 @@ These are expected prototype constraints, not necessarily isolated bugs:
   and the village pantry.
 - NPCs do not have homes, schedules, possessions, memories, relationships,
   goals, or social knowledge.
-- NPC reasoning is logged but not presented through an in-game inspector.
+- The reason inspector exposes current decisions, but deeper historical traces
+  and rejected preconditions are not yet retained.
 - Active navigation is used as if all agents are local; no simulation LOD exists.
 - Unloaded traveling NPCs preserve their state but do not yet advance through
   abstract travel time.