mirror of
https://github.com/kuhyx/steam-backlog-enforcer.git
synced 2026-11-22 23:02:19 +01:00
The installer ships as the steam_installer package beside steam_backlog_enforcer, with its tests, docs and Proton lock. The enforcer's fast install now starts the installer from this checkout. Both appinfo.vdf readers share one key-value decoder (steam_installer.appinfo_kv), and the duplicated test fixtures and helpers are folded into conftest and _cli_helpers so the whole-tree duplicate-code check is clean. check_requirements_sync treats sibling packages as first-party. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WzxdWZCxnNWLtpVwFLVk9w
3.0 KiB
3.0 KiB
do NOT run tests unless specifically instructed to do so or before committing If tests fail on the same issue twice in a row, STOP and ask the user how to proceed instead of continuing to fix and retry. ALWAYS confirm that the feature you add / bug you fixed behaves as it should by running the program after your changes (not tests!) and inspecting output comparing it with what user wanted, after confirming by yourself ask user if the program behaves as they intended After running tests fix all coverage gaps and issues, do not ignore unless specifically instructed to do so
@/home/kuhy/.claude/rules/typescript-5-es2022.instructions.md
Steam Backlog Enforcer Notes
- Fixed in commit 8b7bdb6: conftest.py safety net redirects all filesystem paths (STEAMAPPS_PATH, CONFIG_DIR, STATE_FILE, etc.) to tmp_path. Tests are safe to run without asking about state.json first.
- The pre-commit
pytest-coveragehook is currently broken (measures all of python_pkg at 100%, not just the changed subpackage). There's an in-progress fix viascripts/pytest_changed_packages.py+.pre-commit-config.yamlchange that still needs lint fixes. - Clearing
hltb_cache.jsonalone is not enough forrun.sh/donereassignment:snapshot.jsonalso storescompletionist_hours, and stale snapshot values can still drive reassignment decisions unless refreshed. - After fixing Steam Backlog Enforcer logic, always run a live verification pass with
python_pkg/steam_backlog_enforcer/run.sh(or equivalent command) before declaring the fix done. - cmd_done completion path can pick next game from snapshot-only hours; keep it aligned with HLTB cache/refresh before pick_next_game to avoid prologue-derived stale times (e.g., A Space 0.56h while cache has ~20h).
- HLTB renames games (e.g., "Needy Streamer Overload" → "NEEDY GIRL OVERDOSE"). The old name lives in
game_alias. Bothgame_nameandgame_aliasmust be checked when matching — fixed in_pick_best_hltb_entry. - ALWAYS clear HLTB cache and re-run
run.shafter changing the HLTB picking/matching algorithm. Delete~/.config/steam_backlog_enforcer/hltb_cache.json(entire file, not just one entry) so all games get re-matched with the new logic. Then run./run.shto verify correct results. Stale cache entries from the old algorithm will persist and hide bugs otherwise.
Commands
- run:
./run.sh - test:
python3 -m pytest -q - test-changed:
scripts/test_changed.sh - lint:
pre-commit run ruff --all-files - coverage:
python3 -m pytest -q - coverage-gaps:
coverage-gaps coverage.lcov - deploy:
scripts/deploy.sh - install-game:
steam_installer/run.sh <appid|url|name>(the daemon itself runspython3 -m steam_installer.cli; docs inDOCS-steam-installer.md) - push:
scripts/check_gate_stamp.sh full && git push(every manual-stage gate hook, ~3 min, then push). Agents (60 s cap): one call per id ofscripts/check_gate_stamp.sh full --list:CAP_MEM=4G CAP_CPU_PCT=20 ~/.claude/scripts/capped.sh timeout 55 scripts/check_gate_stamp.sh step <id>(each < 55 s; the last stamps the tree), thengit push.