92 lines
3.7 KiB
Python
92 lines
3.7 KiB
Python
"""Fixed rules that turn self-assessment answers into a chart choice.
|
|
|
|
No scoring. The rules were agreed with the product owner on 2026-11-06:
|
|
|
|
* When the reported time is within ``NEAR_LINE_MINUTES`` of the line, or is a
|
|
rounded time (minute divisible by 15), the reported time carries no real
|
|
preference, so the side with more answers wins. A tie keeps the reported side.
|
|
* Otherwise the reported side is kept unless at least ``OVERRIDE_VOTES`` answers
|
|
point to the other side and at most one answer points to the reported side.
|
|
* Domains whose answer points away from the chosen side are read in both versions.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime
|
|
from typing import Any, Final, Literal
|
|
|
|
Side = Literal["before", "after"]
|
|
NEAR_LINE_MINUTES: Final = 5
|
|
OVERRIDE_VOTES: Final = 4
|
|
|
|
|
|
def reported_is_neutral(reported: datetime, line_at: datetime, *, reported_known: bool) -> bool:
|
|
if not reported_known:
|
|
return True
|
|
if reported.minute % 15 == 0:
|
|
return True
|
|
return abs((reported - line_at).total_seconds()) < NEAR_LINE_MINUTES * 60
|
|
|
|
|
|
def decide(
|
|
answers: dict[str, str],
|
|
*,
|
|
reported_side: Side,
|
|
neutral: bool,
|
|
) -> dict[str, Any]:
|
|
votes = {"before": 0, "after": 0, "unsure": 0}
|
|
for value in answers.values():
|
|
votes[value if value in votes else "unsure"] += 1
|
|
other: Side = "after" if reported_side == "before" else "before"
|
|
if neutral:
|
|
if votes[other] > votes[reported_side]:
|
|
chosen, rule = other, "majority"
|
|
elif votes[reported_side] > votes[other]:
|
|
chosen, rule = reported_side, "majority"
|
|
else:
|
|
chosen, rule = reported_side, "tie_keeps_reported"
|
|
elif votes[other] >= OVERRIDE_VOTES and votes[reported_side] <= 1:
|
|
chosen, rule = other, "strong_override"
|
|
else:
|
|
chosen, rule = reported_side, "reported_kept"
|
|
both_versions = sorted(domain for domain, value in answers.items() if value in ("before", "after") and value != chosen)
|
|
return {
|
|
"chosen_side": chosen,
|
|
"rule": rule,
|
|
"votes": votes,
|
|
"both_versions_domains": both_versions,
|
|
}
|
|
|
|
|
|
def decide_with_evidence(
|
|
answers: dict[str, str], sources: list[dict[str, Any]], *,
|
|
reported_side: Side, neutral: bool, override: Side | None,
|
|
) -> dict[str, Any]:
|
|
sources = [*sources, *(
|
|
{"kind": "supplement", "id": key, "choice": value,
|
|
"before": 0.5 if value == "before" else 0, "after": 0.5 if value == "after" else 0}
|
|
for key, value in answers.items()
|
|
)]
|
|
scores = {side: sum(row[side] for row in sources) for side in ("before", "after")}
|
|
result = decide(answers, reported_side=reported_side, neutral=neutral)
|
|
side, rule = result["chosen_side"], result["rule"]
|
|
if override in ("before", "after"):
|
|
side, rule = override, "user_override"
|
|
result["votes"] = None
|
|
elif abs(scores["before"] - scores["after"]) >= 2:
|
|
side = "before" if scores["before"] > scores["after"] else "after"
|
|
rule = "evidence"
|
|
if rule == "user_override":
|
|
decided_by = "override"
|
|
elif rule == "evidence":
|
|
decided_by = "event" if any(r["kind"] == "event" and r[side] > 0 for r in sources) else (
|
|
"appearance" if any(r["kind"] in ("appearance", "birthmark") and r[side] > 0 for r in sources) else "supplement"
|
|
)
|
|
else:
|
|
decided_by = "supplement" if rule in ("majority", "strong_override") else "reported"
|
|
return {
|
|
**result, "chosen_side": side, "rule": rule, "scores": scores, "sources": sources, "decided_by": decided_by,
|
|
"both_versions_domains": [] if override else sorted(
|
|
key for key, value in answers.items() if value in ("before", "after") and value != side
|
|
),
|
|
}
|