mirror of
https://github.com/kuhyx/steam-backlog-enforcer.git
synced 2026-11-10 20:27:03 +01:00
Krzysztof kuhy Rudnicki
26a2aabbc7
Dormant until earned_time.leisure_active(gaming day) -- the switch file written by `leisure-watch go-live`. From that day: - enforced `seconds` are billed by the shadow rule (lock pause, fail-closed, once per wall clock); budget from plain resolve(); warnings and the cutoff say "Leisure". - at 0, beside the unchanged Steam path, _leisure_kill SIGTERMs (SIGKILL 30 s later, per process) every focus/media pid in now.json except browsers, every failclosed browser pid, and -- with now.json untrusted -- every browser, media player and wsg-grabber reviewer. Root/system, lockers and the enforcer's own chain are never signalled. Kills go to budget.jsonl. - tests: an autouse fixture redirects both switch readers, so no test reads /etc/leisure-watch/leisure_from; existing tests unchanged. Re-pins earned-time to v0.15.0 (leisure_active). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Dsh4Znwh2KnC7q6vbGpX1N
104 lines
3.1 KiB
Python
104 lines
3.1 KiB
Python
"""The cross-tick state the daily budget carries, and how it is built.
|
|
|
|
The audit journal only writes on change, so it needs the previous record. That
|
|
lives on a session that the enforce loop creates once and threads through,
|
|
rather than in module globals.
|
|
|
|
The session's fields are typed by :class:`Protocol` so a test can supply an
|
|
honest stub. A ``MagicMock`` would satisfy every attribute lookup — including
|
|
the ones a refactor forgot to update — which is exactly the failure a type
|
|
would otherwise have caught.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass, field
|
|
from typing import TYPE_CHECKING, Protocol
|
|
|
|
from steam_backlog_enforcer._leisure_kill import LeisureKiller
|
|
from steam_backlog_enforcer._playtime_history import HistoryWriter
|
|
from steam_backlog_enforcer._playtime_log import (
|
|
BudgetLog,
|
|
TickJournal,
|
|
budget_log_path,
|
|
)
|
|
from steam_backlog_enforcer._shadow_log import ShadowJournal
|
|
|
|
if TYPE_CHECKING:
|
|
from steam_backlog_enforcer._playtime_state import PlaytimeRules, PlaytimeState
|
|
from steam_backlog_enforcer._shadow import ShadowVerdict
|
|
|
|
|
|
class TickRecorder(Protocol):
|
|
"""What the budget tick needs from the audit journal."""
|
|
|
|
def observe(
|
|
self,
|
|
qualifying: set[int],
|
|
state: PlaytimeState,
|
|
*,
|
|
rules: PlaytimeRules,
|
|
now_monotonic: float,
|
|
) -> None:
|
|
"""Record this tick if it is worth recording."""
|
|
|
|
|
|
class HistoryRecorder(Protocol):
|
|
"""What the budget tick needs from the per-day history writer."""
|
|
|
|
def observe(self, state: PlaytimeState, *, demo: bool) -> None:
|
|
"""Record today's running total if it has moved far enough."""
|
|
|
|
|
|
class ShadowRecorder(Protocol):
|
|
"""What the budget tick needs from the shadow verdict journal."""
|
|
|
|
def observe(self, verdict: ShadowVerdict, state: PlaytimeState) -> None:
|
|
"""Record the shadow verdict if it changed."""
|
|
|
|
|
|
class LeisureEnforcer(Protocol):
|
|
"""What the budget tick needs from the Phase 2 leisure killer."""
|
|
|
|
def enforce(
|
|
self,
|
|
state: PlaytimeState,
|
|
rules: PlaytimeRules,
|
|
*,
|
|
verdict: ShadowVerdict,
|
|
stamp: float,
|
|
) -> None:
|
|
"""Signal leisure apps if the leisure budget is spent."""
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class PlaytimeSession:
|
|
"""Per-daemon logging state."""
|
|
|
|
journal: TickRecorder
|
|
history: HistoryRecorder
|
|
shadow: ShadowRecorder
|
|
# Defaulted (records nowhere) so a session built without it still kills;
|
|
# new_session wires it to the budget log.
|
|
leisure: LeisureEnforcer = field(default_factory=LeisureKiller)
|
|
|
|
|
|
def new_session(*, demo: bool = False) -> PlaytimeSession:
|
|
"""Build the session the enforce loop threads through every tick.
|
|
|
|
Args:
|
|
demo: Whether this is a short-budget demo run. Demo runs journal to
|
|
their own file, so they cannot plant records in the production
|
|
audit trail.
|
|
|
|
Returns:
|
|
A session for this daemon run.
|
|
"""
|
|
log = BudgetLog(path=budget_log_path(demo=demo))
|
|
return PlaytimeSession(
|
|
journal=TickJournal(log),
|
|
history=HistoryWriter(),
|
|
shadow=ShadowJournal(log),
|
|
leisure=LeisureKiller(log),
|
|
)
|