docs: capture player standing and quest system in plans and schema

2026-08-08 20:50:59 +02:00
parent 3b6e35ba6d
commit 21b2eb06da
5 changed files with 67 additions and 3 deletions
@@ -21,6 +21,8 @@ SimulationClock
        -> EventKnowledgeSystem records, ranks, transfers, and retains bounded knowledge
        -> RelationshipSystem applies evidence-gated social consequences
        -> VillageOpportunitySystem projects one known unresolved need
+        -> PlayerQuestSystem turns open needs into named player quests and
+           grants Standing as the player resolves them through real supply/feed
    -> WorldViewManager presents travel, NPC state, and world-state cues
        -> ActiveWorldAdapter supplies loaded-world positions/capacity
            -> LoadedResourceSpatialIndex bounds finite-anchor discovery
@@ -64,6 +66,15 @@ would otherwise obscure that lifecycle:
  When no such helper exists, it can separately derive an ephemeral
  `OpportunityPlayerResponseResult` from the real destination capacity and
  enabled player-usable finite sources;
+- `simulation/quests/PlayerQuestSystem.gd` turns real open needs into named
+  player quests (`PlayerQuestRecord`) and owns the player's `PlayerStandingRecord`
+  reputation. A quest is generated only when the player can genuinely act
+  through the ordinary economy (an unassisted pantry/wood shortage, or a hungry
+  player-feedable animal), and it is resolved only by a real player supply or
+  feed event. Completing a quest grants Standing and raises the requester's
+  gratitude; a requester who personally trusts the player can ask them directly
+  even when another capable helper exists. Quests, Standing, and gratitude are
+  persisted and never become quest-only simulation state;
 - `simulation/persistence/` owns save-slot file safety;
 - `simulation/state/` owns versioned serialized record contracts;
 - `simulation/definitions/` owns stable IDs and immutable action/profession
@@ -102,6 +113,7 @@ hard to read.
 | `simulation/relationships/` | Directed social consequences and relationship queries |
 | `simulation/population/` | Transient per-tick population query indexes |
 | `simulation/opportunities/` | Knowledge-gated unresolved-condition projections |
+| `simulation/quests/` | Named player quests and Standing reputation from real need resolution |
 | `simulation/state/` | Versioned, serializable mutable records |
 | `simulation/definitions/` | Stable IDs and immutable gameplay definitions |
 | `simulation/persistence/` | Validated local save-file storage |