Source:

• src/ometeotl_core/model/projection.py

Local role: Projected successor perceived state produced by evaluating one Action from one source Perception.

Big-picture role: Bridge object between first-order projection and later strategy construction: it is the state that child strategy nodes consume.

Inheritance:

• dataclass

Parameters and fields:

• source_perception_id: str
• generating_action_id: str
• perception: Perception — deep copy of the source perception, marked epistemic_status="projected" on perceived spaces, memberships, relations, and perceived component links
• changes: list[ProjectedPerceptionChange] — sorted by change_id on serialization
• metadata: dict

Context keys written into perception.context:

• projected_state_changes — map of action-id to state-change payloads from action.state_changes
• projected_stock_deltas — map of resource_id to cumulative quantity delta for stock resources (mode "stock" with quantity != 1.0); consume subtracts, produce adds, transfer subtracts from source

Methods:

• to_dict() -> dict
• from_dict(data) -> ProjectedPerceptionState

See also:

• ProjectedPerceptionChange
• ActionProjection
• Perception