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