Files
Jyotisha/scripts/chart_choice/decision.py
T
2026-11-13 14:36:26 +08:00

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
),
}