steam-backlog-enforcer/steam_backlog_enforcer
Krzysztof kuhy Rudnicki 8d31e8e9af
Some checks are pending
dependency freshness / dependencies on newest stable (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
pre-commit / pre-commit (push) Waiting to run
Tests / test (push) Waiting to run
Cut the daily gaming budget to 6h on a day with no workout
8h is now earned rather than given. A gaming day with a counted workout
logged in screen-locker gets daily_gaming_seconds; a day without gets the
new unearned_gaming_seconds floor. Skipping a workout costs two hours the
same day, instead of nothing until the weekly lock fires.

The fact comes from screen-locker's GET /api/status, which reports only
workout_today -- the hour values live here. Neither repo can drift from the
other about what a workout day is: that flag is derived from
count_day_credits, the same rule the locker enforces with.

Every way of not getting an answer applies the floor, logged at warning with
the URL and the concrete error. Failing open would let the coupling be
defeated by stopping one user service, and a silent 8h would be
indistinguishable from an earned one.

resolve_budget_seconds is called from rules_for rather than at each call
site, because the daemon holds one Config for its whole life while
_budget_view reloads it per HTTP request. Resolved at only one of those and
the web UI would report a budget the daemon was not enforcing -- the exact
silent divergence this codebase is built to prevent.

A budget that rises mid-day now releases the block properly.
_release_after_raise clears blocked_at, which otherwise only roll_over reset
and which would leave the UI reporting "blocked" while gaming worked, and
clears warned_seconds, which is keyed on seconds *remaining* and would
otherwise let the extra two hours arrive with no warnings at all.

Known and accepted (2026-08-29): the budget can DROP mid-day if the resolved
answer changes under a day already in progress, re-pricing time already
spent and cutting off on the next tick with no warning. The module docstring
says so plainly rather than claiming a monotonicity the code does not
implement; the fix, if it ever bites, is a persisted granted_budget_seconds.

Tests get an autouse stub for the lookup. Without it every test that builds
rules makes a real loopback request, and the suite would pass in the morning
and fail in the evening depending on whether the machine's owner had trained.
test_budget_view builds its RULES at import time, before fixtures apply, so
it stubs the resolver explicitly.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fcwu78wk17FWMHbbfbyicc
2026-08-29 23:11:27 +02:00
..
docs Auto-detect completed manual picks before enforcing the pick cap 2026-08-29 14:53:04 +02:00
main Make serve re-runnable, and cover it to 100% 2026-08-29 18:52:11 +02:00
tests Cut the daily gaming budget to 6h on a day with no workout 2026-08-29 23:11:27 +02:00
__init__.py feat: steam 100 percent extension 2026-03-02 20:29:32 +01:00
_actions.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_allowed_games.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_attribution_labels.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_budget_games.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_budget_log_tail.py Show the gaming budget in the web UI 2026-08-29 07:17:42 +02:00
_budget_view.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_cdp.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_cmd_done_finalize.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_cmd_done.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_cmd_playtime.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_config_setup.py Show the gaming budget in the web UI 2026-08-29 07:17:42 +02:00
_controller_input.py Bill gaming time only while the user is actually playing 2026-08-28 19:24:14 +02:00
_counted_procs.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_desktop_env.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
_echo.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
_enforce_loop.py Auto-detect completed manual picks before enforcing the pick cap 2026-08-29 14:53:04 +02:00
_enforce_steps.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
_engagement_probes.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_engagement_types.py Bill gaming time only while the user is actually playing 2026-08-28 19:24:14 +02:00
_game_names.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
_hltb_cached.py Split _actions, _whitelist, _cmd_done and hltb under the cap 2026-08-24 14:55:57 +02:00
_hltb_comp_extract.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_hltb_confidence.py Split _actions, _whitelist, _cmd_done and hltb under the cap 2026-08-24 14:55:57 +02:00
_hltb_detail.py Bring the HLTB modules under the 250-line cap 2026-08-24 15:23:13 +02:00
_hltb_matching.py Bring the HLTB modules under the 250-line cap 2026-08-24 15:23:13 +02:00
_hltb_page_parse.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_hltb_search_api.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_hltb_search.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_hltb_types.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_hosts_protection.py Split store_blocker along its one-way call boundaries 2026-08-24 15:06:15 +02:00
_manual_pick_lifecycle.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_mcp_actions.py Auto-detect completed manual picks before enforcing the pick cap 2026-08-29 14:53:04 +02:00
_mcp_gaming_time.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_mcp_query.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_mcp_server.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_mcp.py Split total-block, playtime and MCP by responsibility 2026-08-23 20:52:08 +02:00
_owned_apps_cache.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_pacman.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_pick_completion.py Auto-detect completed manual picks before enforcing the pick cap 2026-08-29 14:53:04 +02:00
_playtime_block.py Split total-block, playtime and MCP by responsibility 2026-08-23 20:52:08 +02:00
_playtime_budget.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_playtime_cutoff.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_playtime_engagement.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_playtime_history_parse.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_playtime_history.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_playtime_kill.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_playtime_log.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_playtime_mountinfo.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_playtime_notify.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_playtime_procs.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_playtime_run.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_playtime_session.py Show the gaming budget in the web UI 2026-08-29 07:17:42 +02:00
_playtime_state.py Cut the daily gaming budget to 6h on a day with no workout 2026-08-29 23:11:27 +02:00
_playtime.py Cut the daily gaming budget to 6h on a day with no workout 2026-08-29 23:11:27 +02:00
_polls_reporting.py Split steam_api and _scanning_confidence under the cap 2026-08-24 14:25:43 +02:00
_protected_apps.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
_scanning_assign.py Auto-detect completed manual picks before enforcing the pick cap 2026-08-29 14:53:04 +02:00
_scanning_candidates.py Bring _stats.py and scanning.py under the 250-line cap 2026-08-24 16:00:54 +02:00
_scanning_confidence.py Split steam_api and _scanning_confidence under the cap 2026-08-24 14:25:43 +02:00
_scanning_tampering.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_screen_hold.py Bill gaming time only while the user is actually playing 2026-08-28 19:24:14 +02:00
_serve_guard.py Make serve re-runnable, and cover it to 100% 2026-08-29 18:52:11 +02:00
_serve_startup.py Make serve re-runnable, and cover it to 100% 2026-08-29 18:52:11 +02:00
_snapshot.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_stats_display.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_stats_gathering.py Bring _stats.py and scanning.py under the 250-line cap 2026-08-24 16:00:54 +02:00
_stats_types.py Bring _stats.py and scanning.py under the 250-line cap 2026-08-24 16:00:54 +02:00
_stats.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_steam_api_client.py Split steam_api and _scanning_confidence under the cap 2026-08-24 14:25:43 +02:00
_steam_client.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
_steam_errors.py Bill gaming time only while the user is actually playing 2026-08-28 19:24:14 +02:00
_steam_launch.py Bill gaming time only while the user is actually playing 2026-08-28 19:24:14 +02:00
_steam_models.py Split steam_api and _scanning_confidence under the cap 2026-08-24 14:25:43 +02:00
_steam_process.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
_steam_restart_guard.py Bill gaming time only while the user is actually playing 2026-08-28 19:24:14 +02:00
_steam_state.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
_store_iptables.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_total_block_domains.py Split total-block, playtime and MCP by responsibility 2026-08-23 20:52:08 +02:00
_total_block_hosts.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_total_block_iptables.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_total_block_launchers.py Split total-block, playtime and MCP by responsibility 2026-08-23 20:52:08 +02:00
_total_block_purge.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_total_block.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_web_build.py Make serve re-runnable, and cover it to 100% 2026-08-29 18:52:11 +02:00
_web_dataset.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
_web_games.py Bring _web_dataset.py under the 250-line cap — cap campaign complete 2026-08-24 16:08:12 +02:00
_web_models.py Bring _web_dataset.py under the 250-line cap — cap campaign complete 2026-08-24 16:08:12 +02:00
_web_pace.py Bring _web_dataset.py under the 250-line cap — cap campaign complete 2026-08-24 16:08:12 +02:00
_web_server.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_whitelist_locking.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_whitelist.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
_workout_budget.py Cut the daily gaming budget to 6h on a day with no workout 2026-08-29 23:11:27 +02:00
_x_focus.py Bill gaming time only while the user is actually playing 2026-08-28 19:24:14 +02:00
_x_probe.py Bill gaming time only while the user is actually playing 2026-08-28 19:24:14 +02:00
config.py Cut the daily gaming budget to 6h on a day with no workout 2026-08-29 23:11:27 +02:00
enforcer.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
game_install.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
game_uninstall.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
hltb.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
library_hider.py Stop the enforcer launching Steam and notifications as root 2026-08-24 13:55:44 +02:00
protondb.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00
scanning.py Show which games make up the gaming budget, and bill osu!lazer 2026-08-29 18:32:03 +02:00
steam_api.py Split steam_api and _scanning_confidence under the cap 2026-08-24 14:25:43 +02:00
store_blocker.py Grade against 3.14 too, not just run on it 2026-08-29 11:44:25 +02:00