LexicographicUtility

Source:

src/ometeotl_core/game/utility.py

Local role: Vector-valued utility combinator with explicit criterion ordering and direction.

Big-picture role: Game-layer multi-criteria scoring primitive for lexicographic ranking.

Inheritance:

UtilityFunction

Constructor:

LexicographicUtility(framework_id, metric_order, metric_directions=None)

Method:

evaluate(perception, actor, context) -> UtilityFrame

Example:

from ometeotl_core.game.utility import LexicographicUtility

# Safety is paramount; speed is the tiebreaker
utility = LexicographicUtility(
    framework_id="safety_first",
    metric_order=["safety", "speed"],
    metric_directions={"safety": "max", "speed": "max"},
)
frame = utility.evaluate(
    perception,
    actor,
    context={"safety": 0.9, "speed": 0.5},
)
print(frame.value)            # [0.9, 0.5]
print(frame.criteria_labels)  # ["safety", "speed"]
print(frame.is_multi_criteria) # True

Ometeotl