Source:

• src/ometeotl_core/model/projection.py

Local role: Minimal concrete ProjectionTool that turns action/perception/resource inputs into explicit assumptions and one projected successor perceived state without executing actions or building strategy nodes.

Big-picture role: First-order strategizing helper: it prepares both the assumption basis and the next perceived state that later strategy-building steps may consume.

Inheritance:

• ProjectionTool

Methods:

• project_action(action, perception, resources=()) -> ActionProjection
  • Builds ProjectionAssumption entries for actor binding, source context, space binding, each ResourceEffect (indexed as effect:{idx}:…), and each ActionPrerequisite (indexed as prerequisite:{idx}:…).
  • For consume/transfer effects, verifies that the resource has a PerceivedMembership in effect.source_id (or action.space_id as fallback); sets satisfied=False when the resource is not perceived there.
  • Calls _build_projected_perception_state and attaches the result as projected_state.
  • Status is "projected" when all required resources are satisfied and the actor matches; "partial" if resources or actor mismatch; "blocked" otherwise.
• inherited project_actions(actions, perception, resources=()) -> ProjectionBatch

Resource projection modes:

• Discrete (resource_mode != "stock" or quantity == 1.0): consume removes PerceivedMembership, produce appends one, transfer moves membership between spaces.
• Stock (resource_mode == "stock" and quantity != 1.0): writes a cumulative delta to perception.context["projected_stock_deltas"] instead of changing memberships.

Related module-level function:

• reconstruct_model_object in src/ometeotl_core/model/registry.py

See also:

• ProjectionAssumption
• ActionProjection
• ProjectedPerceptionState