Files
lucidia-main/human_machine/decision_support.py
Alexa Amundson 855585cb0e sync: update from blackroad-operator 2026-03-14
Synced from BlackRoad-OS-Inc/blackroad-operator/orgs/personal/lucidia
BlackRoad OS — Pave Tomorrow.

RoadChain-SHA2048: fe729062952871e7
RoadChain-Identity: alexa@sovereign
RoadChain-Full: fe729062952871e77147cf6d938b799096e87d9024d7005a14c9e209e12e8ad0c825b624c7bc649fc7eeb4c284fdcab8231af77980065cc04d9f36fca479ffc2346ed3c1b73de6f240d8f9485f47c995ad5b81142f7179b84932c67914dff1c08db039349ba28fca36cb57688093bf0199268dd1c2f3448c9383000bc77cc9663066ff57b834370afc8838b18466ea9029908018b961555cccaabf2ce21649cf3cabc7f64bdcc4abdf2da259b210c342835a2cecf92bdd3b4e109b4d6e622f6934e13b2b123607bd61ce3d0f20454c9ab594f9284cffe18716619c52db57ce5f4ee2856cb96e1fa3748fe1fe65435bec297c5ab3ab58d570ec1064aea29931dd
2026-03-14 15:09:52 -05:00

64 lines
1.8 KiB
Python

from __future__ import annotations
from dataclasses import dataclass
from typing import Dict, Any, Callable, Optional
@dataclass
class Decision:
"""Represents a decision with a set of options and a selected recommendation.
Attributes
----------
options : Dict[str, Any]
A mapping of option names to their underlying values.
recommendation : Optional[str]
The name of the option that is currently recommended. None if no
recommendation is available.
"""
options: Dict[str, Any]
recommendation: Optional[str] = None
class DecisionSupport:
"""
Simple decision support system that ranks options based on a scoring function.
A `scorer` callable is provided to map option values to numeric scores. The
`evaluate` method selects the option with the highest score.
"""
def __init__(self, scorer: Callable[[Any], float]) -> None:
self.scorer = scorer
def evaluate(self, options: Dict[str, Any]) -> Decision:
"""
Evaluate and recommend the option with the highest score.
Parameters
----------
options : Dict[str, Any]
A mapping from option names to their raw values.
Returns
-------
Decision
A Decision object containing the original options and the recommended key.
"""
if not options:
return Decision(options, None)
scores = {name: self.scorer(val) for name, val in options.items()}
best = max(scores, key=scores.get)
return Decision(options, best)
if __name__ == "__main__":
# Example: choose the largest number
def identity_score(x: float) -> float:
return x
ds = DecisionSupport(identity_score)
opts = {"A": 0.5, "B": 0.8, "C": 0.3}
result = ds.evaluate(opts)
print("Recommendation:", result.recommendation)