kuhyx/steam-backlog-enforcer
1
0
Fork 0
mirror of https://github.com/kuhyx/steam-backlog-enforcer.git synced 2026-11-11 19:13:49 +01:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity
db44ca5b0b
steam-backlog-enforcer/AGENTS.md
Krzysztof kuhy Rudnicki db44ca5b0b
Some checks are pending
dependency freshness / dependencies on newest stable (push) Waiting to run
Details
md-naming / markdown naming convention (push) Waiting to run
Details
pre-commit / pre-commit (${{ matrix.group }}) (mypy, mypy, ) (push) Waiting to run
Details
pre-commit / pre-commit (${{ matrix.group }}) (pylint, pylint, ) (push) Waiting to run
Details
pre-commit / pre-commit (${{ matrix.group }}) (rest, , mypy,pylint) (push) Waiting to run
Details
Tests / test (push) Waiting to run
Details
Tests / web-coverage (push) Waiting to run
Details
repo-contract / repo contract (push) Waiting to run
Details
Split ci-mirror gate into <60 s steps 
The single ci-mirror manual hook (clean venv + pre-commit --all-files +
serial pytest) ran past the 60 s per-command cap, so the tree could not be
stamped for a push. It is now nine gate steps, each under 55 s at load ~40:

- ci-mirror-venv / -precommit / -pytest: scripts/ci_mirror.sh parts;
  pytest runs on 4 xdist workers, pytest-cov still enforces 100 %.
- ci-mirror-pylint-{pkg,tests-1,tests-2,tests-3}: per-file checks over a
  partition of the pylint hook's targets; -dup and -cycles: the two
  cross-file checks on the whole tree. pylint is now a local hook so all of
  them share one env (&pylint_env, pylint==4.0.9).
- scripts/pylint_symilar_cache.py: pylint plugin that hashes each file once
  for duplicate-code instead of once per file pair (same R0801 output).

Tests: an autouse guard refuses non-loopback DNS (several tests made live
HLTB requests), two web fixtures poll at 0.01 s, and the rate-limit test
uses a fake clock. CLAUDE.md and AGENTS.md get the push line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWWjUkRCFGNMnnXZrSP
2026-11-11 16:29:08 +01:00

2.9 KiB
Raw Blame History

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-coverage hook is currently broken (measures all of python_pkg at 100%, not just the changed subpackage). There's an in-progress fix via scripts/pytest_changed_packages.py + .pre-commit-config.yaml change that still needs lint fixes.
  • Clearing hltb_cache.json alone is not enough for run.sh/done reassignment: snapshot.json also stores completionist_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. Both game_name and game_alias must be checked when matching — fixed in _pick_best_hltb_entry.
  • ALWAYS clear HLTB cache and re-run run.sh after 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.sh to 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
  • 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 of scripts/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), then git push.