steam-backlog-enforcer/steam_backlog_enforcer
Krzysztof kuhy Rudnicki 433a1d6c28
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
Stop the web UI serving numbers the enforcer is not applying
A server started as `python -c "from ..._web_server import serve; serve(
port=8000)"` ran for five hours after the code beneath it changed, reporting
an 8h gaming budget while the daemon enforced 6h and had already cut gaming
off. Two separate holes let that happen.

The staleness check only ran from cmd_serve, so a server started any other
way never met it. And is_our_server matched argv containing
"steam_backlog_enforcer.main", which a `python -c` process does not have --
so that server could not even be identified as ours: `run.sh serve` would
have refused the port and named it as a stranger rather than replacing it.

_serve_stale puts the check inside the server, where no launch path can skip
it. Every route, static included, returns 503 once any package .py is newer
than this process, because a fresh page fetching stale numbers is the same
lie with extra steps. The answer is memoised for five seconds so it does not
stat the package per request; that bounds the staleness window instead of
leaving it open forever.

Refusing is only half a fix -- a process that 503s forever is honest and
useless -- so a refused request also stands the server down. The new
steam-backlog-enforcer-web.service supplies the other half with
Restart=always: it dies on stale code and returns on current code with
nobody having to remember anything. A user unit, not a system one; it serves
read-only views and needs no privilege. install.sh installs and enables it
rather than printing instructions.

is_our_server now substring-matches the joined argv, so run.sh serve,
python -m ...main serve and a bare python -c are all recognised.

newest_py_since moves into _serve_stale and _serve_guard delegates to it.
Both needed the same scan, and two copies would have been free to disagree
about whether a server is current -- which is the entire failure being fixed.

Verified end to end: healthy 200, touch _budget_view.py, next request 503,
systemd replaces the process, back to 200 reporting 6.0h and blocked=True.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fcwu78wk17FWMHbbfbyicc
2026-08-29 23:39:40 +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 Stop the web UI serving numbers the enforcer is not applying 2026-08-29 23:39:40 +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 Stop the web UI serving numbers the enforcer is not applying 2026-08-29 23:39:40 +02:00
_serve_stale.py Stop the web UI serving numbers the enforcer is not applying 2026-08-29 23:39:40 +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 Stop the web UI serving numbers the enforcer is not applying 2026-08-29 23:39:40 +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