"""Offline teaching exercise. Does not send requests, sleep, or call a model."""
from datetime import datetime, timezone
from email.utils import format_datetime, parsedate_to_datetime
from pathlib import Path
import json
import math
import re

NOW = datetime(2026, 10, 24, 16, 0, 0, tzinfo=timezone.utc)
MAX_RETRIES = 2  # additional attempts after the original
WAIT_BUDGET = 30.0  # illustrative remaining total deadline, not provider policy
JITTER = 0.5  # fixed authored value for reproducible examples, not random jitter


def parse_retry_after(value, now):
    """Accept ASCII integer seconds or canonical IMF-fixdate; reject ambiguity."""
    if not isinstance(value, str) or len(value) > 128:
        raise ValueError("missing or oversized header")
    value = value.strip()
    if re.fullmatch(r"[0-9]+", value):
        return int(value)
    date = parsedate_to_datetime(value)
    if date.tzinfo is None or format_datetime(date, usegmt=True) != value:
        raise ValueError("expected canonical GMT HTTP date")
    return max(0, math.ceil((date - now).total_seconds()))


def plan(case):
    status = case["status"]
    if 200 <= status < 300:
        return {"action": "done", "reason": "response_success"}
    if case.get("repeat_safe") is not True:
        return {"action": "stop", "reason": "repeat_safety_unconfirmed"}
    retries = case.get("retries_done", 0)
    if type(retries) is not int or not 0 <= retries <= MAX_RETRIES:
        raise ValueError("invalid retry count")
    if retries >= MAX_RETRIES:
        return {"action": "stop", "reason": "retry_limit"}
    if status not in (429, 503):
        return {"action": "stop", "reason": "outside_demo_policy"}
    header = case.get("retry_after")
    if header is None and status == 429:
        return {"action": "review", "reason": "429_without_wait_hint"}
    if header is None:
        delay = 2 ** retries
        basis = "authored_backoff"
    else:
        try:
            delay = parse_retry_after(header, NOW)
        except (ValueError, TypeError, OverflowError):
            return {"action": "review", "reason": "invalid_wait_hint"}
        basis = "retry_after"
    # Compare before float conversion; even an enormous integer stops safely.
    elapsed = case.get("elapsed_seconds", 0)
    if type(elapsed) not in (int, float) or not math.isfinite(elapsed) or elapsed < 0:
        raise ValueError("invalid elapsed time")
    remaining = WAIT_BUDGET - elapsed
    if delay > remaining - JITTER:
        return {"action": "stop", "reason": "deadline_budget"}
    return {"action": "would_wait", "seconds": delay + JITTER, "basis": basis}


def main():
    cases = json.loads(Path(__file__).with_name("retry-cases.json").read_text(encoding="utf-8"))
    results = [{"id": case["id"], **plan(case)} for case in cases]
    print(json.dumps({"mode": "offline_authored_cases", "fixed_clock": NOW.isoformat(),
                      "max_additional_retries": MAX_RETRIES, "deadline_seconds": WAIT_BUDGET,
                      "fixed_jitter_seconds": JITTER, "results": results}, indent=2))


if __name__ == "__main__":
    main()
