utils/earned_time/earned_time/_sick.py
Krzysztof kuhy Rudnicki 2f8cf7d6e5 earned_time: add the LeetCode review top-up
A finished coach review pays 20 shutdown minutes, once a day, as a
top-up: never a rung, never in the floor, added last and capped at the
ceiling (sick days too). A row pays only if signed, sourced, first for
its slug ever, and backed by a signed non-manual accepted submission
in the guard ledger from the 14 days before. From 2026-11-23.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWXLvi9aq4MxL4XHKJ4
2026-11-21 22:09:35 +01:00

64 lines
2.4 KiB
Python

# Copyright (c) 2026 Krzysztof Rudnicki
"""The sick-day shutdown: 20:00 plus what the day earned, at gaming pay.
0.11.0 floored the final shutdown at 20:00 without stacking, so a sick day
that did LeetCode and reading still shut down at 20:10 (kuhy, 2026-10-17:
"+1 h from book and +1 h from LeetCode" was expected). Since 0.13.0 a sick
day shuts down at ``SICK_SHUTDOWN_FLOOR_MINUTES`` plus every term's *gaming*
minutes (shutdown follows the gaming bonus), capped at the day's ceiling.
Never below 0.11.0's ``max(20:00, earned)``: every earner's gaming pay is at
least its rung and the ladder floor is below 20:00, so it may land same-day.
Only shutdown moves. Gaming time, the registry, waivers and penalties are
untouched, and every earner still earns on a sick day.
Whether a day is sick is the consumer's answer (the ``sickdays`` pool):
this package is stdlib-only and never imports it.
"""
from __future__ import annotations
from typing import TYPE_CHECKING, Final
from earned_time._gaming import gaming_enforced
from earned_time._ladder import shutdown_ceiling_for
if TYPE_CHECKING:
from collections.abc import Sequence
from datetime import date
from earned_time._resolution import Term
# 20:00, minutes after local midnight.
SICK_SHUTDOWN_FLOOR_MINUTES: Final = 20 * 60
def sick_shutdown_from(paid_minutes: int, day: date) -> int:
"""A sick day's shutdown: 20:00 plus ``paid_minutes``, capped.
Args:
paid_minutes: The day's terms at gaming pay (``sum(t.gaming_minutes)``).
day: The day, which picks the ceiling.
Returns:
``min(ceiling, SICK_SHUTDOWN_FLOOR_MINUTES + paid_minutes)``.
"""
return min(shutdown_ceiling_for(day), SICK_SHUTDOWN_FLOOR_MINUTES + paid_minutes)
def sick_or(earned: int, terms: Sequence[Term], day: date) -> int:
"""A sick day's shutdown: 20:00 plus the paid terms, never below ``earned``.
The terms are paid at gaming pay before ``GAMING_UNLIMITED_FROM`` and at
their shutdown (rung) pay from it: the gaming budget no longer exists.
A top-up adds its shutdown minutes last, capped (0.23.0).
"""
paying = [t for t in terms if not t.earner.topup]
if gaming_enforced(day):
paid = sum(t.gaming_minutes for t in paying)
else:
paid = sum(t.shutdown_minutes for t in paying)
topup = sum(t.shutdown_minutes for t in terms if t.earner.topup)
lifted = min(shutdown_ceiling_for(day), sick_shutdown_from(paid, day) + topup)
return max(earned, lifted)