fix(docs): correct the Observation 'frozen' claim - the dataclass is frozen at the top level but the inner per-combatant/pair dicts are mutable copies; wording softened in the docstring and README (deep-freeze rejected: it would change the LLM contract and require touching pinned observation tests; copies are never read back by the engine, so policy mutation is already inert)
This commit is contained in:
@@ -1578,8 +1578,11 @@ Règles modélisées :
|
||||
`spell_slots` sans clés dupliquées.
|
||||
- Snapshot d'observation (contrat LLM, Phase 2) : avant chaque appel de
|
||||
politique, le moteur construit une `Observation` sérialisable (`to_dict()` →
|
||||
JSON) figée — le snapshot est la SEULE source d'info de la LLM (aucune
|
||||
référence `engine.*` exposée, collections copiées/figées). Une politique LLM
|
||||
JSON) isolée du combat — le snapshot est la SEULE source d'info de la LLM
|
||||
(aucune référence `engine.*` exposée, collections copiées, jamais relues en
|
||||
retour : la politique peut les muter sans affecter le combat ; l'objet est un
|
||||
dataclass figé au premier niveau, les dictionnaires internes sont des copies
|
||||
mutables, non deep-freezés). Une politique LLM
|
||||
se branche via `CombatEngine(..., llm_policy=...)` (`LLMPolicy(observation,
|
||||
state) -> tuple[Action, ...]`). Schéma enrichi (E1-E5) :
|
||||
- Par combattant : id, side, pos, occupied_cells, hp/hp_max, active/dead,
|
||||
|
||||
Reference in New Issue
Block a user