Compare commits

...
556 Commits
Author SHA1 Message Date
poli0981 eb426b84a2 Merge pull request #262 from poli0981/release/v4.7.2
release: v4.7.2 "Steady State" / apps 2.5.2
2026-11-17 09:13:18 +07:00
poli0981andClaude Opus 5.5 0502947701 release: v4.7.2 "Steady State" / apps 2.5.2
The first release in maintenance mode, and a security one: the apps take
rustix 1.1.6 (RUSTSEC-2026-0486, reachable through the updater's tar and
xattr code), the About page's data-only report links, and two weeks of
dependency updates; the repository gains Qodana with its first findings
fixed.

Version bumps: web/package.json and its lock, src-tauri/Cargo.toml and the
f2p-tracker entry in Cargo.lock, and tauri.conf.json (Android's versionCode
derives from it).

The first release under the changelog split: [Unreleased] becomes
changelog/v4/4.7.x/4.7.2.md (sub-headings up one level, an intro first,
and the "no release yet" phrases reworded), CHANGELOG.md keeps an empty
[Unreleased] and gains the release's row. The GitHub release's notes are
that file below its title and back link.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 09:05:23 +07:00
poli0981 a551e57ca1 Merge pull request #261 from poli0981/docs/changelog-split
docs: split CHANGELOG.md into one file per release
2026-11-17 09:05:17 +07:00
poli0981andClaude Opus 5.5 ec1bf939f6 docs: split CHANGELOG.md into one file per release
changelog/v<major>/<major>.<minor>.x/<version>.md for each of the 42
releases from v1.0.0 to v4.7.1, and changelog/beta/ for pre-releases
(none has been published; its README says how one would be filed).
CHANGELOG.md becomes the index: what the layout is, [Unreleased] exactly
as it was, and a table per major version (version, date, edition) that
links each file.

Each file is its section, copied byte for byte except that its heading
is the file's H1 (so the sub-headings move up one level, outside code
fences), relative links gain ../../../ so they name the same repository
paths, and the --- separators between sections are gone. Checked by
reversing all three changes on every file and comparing with the
original section: 40 of 40 equal. Two releases had no section: v1.0.0
(its GitHub release notes, which the changelog pointed to as "Initial
stable") and v1.1.3 (its tag message).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 09:02:37 +07:00
poli0981andClaude Opus 5.5 d482013cf7 docs: name changelog/ where CHANGELOG.md is named
README's link, the export-ignore beside CHANGELOG.md's, the watch-paths
note in DEPLOYMENT.md, and a CLAUDE.md rule for where release notes go
and how a release moves [Unreleased] into its own file.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 09:02:17 +07:00
poli0981 496643c16c Merge pull request #258 from poli0981/ci/qodana
ci: Qodana scans for Python, JS/TS and Rust, and their first findings
2026-11-17 09:02:00 +07:00
poli0981 53fa5957ea Merge pull request #260 from poli0981/fix/rustix-1.1.6
fix(deps): rustix 1.1.6 (RUSTSEC-2026-0486)
2026-11-17 09:00:40 +07:00
poli0981andClaude Opus 5.5 3f05d9fc45 fix(deps): rustix 1.1.6 (RUSTSEC-2026-0486)
rustix 1.0.0-1.1.5 marks as initialised the bytes an extended-attribute
call (getxattr, listxattr and their l/f forms) never wrote when given a
zero-length buffer - undefined behaviour from safe code. Fixed in 1.1.6
(2026-10-27). In the Tauri shell it comes in through async-io, polling,
zbus and tempfile, and the affected calls through tauri-plugin-updater ->
tar -> xattr. Dependabot raised no alert; an OSV querybatch over
Cargo.lock found it.

Cargo.lock: rustix's version and checksum only. `cargo update -p rustix
--precise 1.1.6` (cargo 1.99) also re-pointed thirteen unrelated
dependency edges to older windows-sys versions and one from syn 3 to
syn 2, so the entry was edited by hand instead; rustix 1.1.6's minimums
(bitflags 2.9.2, errno 0.3.10, libc 0.2.182, windows-sys >=0.52,<0.62)
are all met by what is locked. `cargo metadata --locked` (every platform)
and `cargo test --lib --locked` pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:58:13 +07:00
poli0981andClaude Opus 5.5 2e28d44885 docs: Qodana in README, DEPLOYMENT, CLAUDE.md and the changelog
README: a Qodana badge and the workflow in the list of scanners.
DEPLOYMENT: what qodana.yml runs, the three secrets, the gate, and what
to remove if the licence ends. CLAUDE.md: the setup and the traps the
first runs found (no interpreter in native Python, the Rust image's
missing linker and libraries, plugins only in Docker, the lucide import
false positive). CHANGELOG [Unreleased]: the Qodana entry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:54:28 +07:00
poli0981andClaude Opus 5.5 c9e133d3ef test: the branches the Qodana fixes touched
SonarCloud's gate wants 80% coverage on new code, and the PR's changed
lines were at 71.8%: ten of them were never run by a test. Now they are:

- appdetails' failures told apart (no answer, 404, success: false, a
  body that is not JSON) and the store page's two network_error paths;
- the leaderboards' stars, for a percentage and for "N/A", "No reviews"
  and a missing field (both scripts);
- mark_dead_games.parse_players() on the stored formatted strings;
- backfill_discover.parse_released() on every date shape, the year-only
  one included.

pytest: 501 passed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:54:28 +07:00
poli0981andClaude Opus 5.5 55fcf1342a ci(qodana): zero-problem quality gate, exclusions with their reasons
Each qodana.yaml now fails its job on any problem (failureConditions,
any: 0), as in free-games-itchio-list, and names what it leaves out and
why:

- Python: DuplicatedCode in the two discovery and two leaderboard
  scripts (sharing them is a refactor); broad excepts where a failed
  request is "no answer" by design (steam_client, the Access diagnosis);
  PyCharm's sorted() typing in edit_game.py; the escaped bracket pair in
  normalize.py's `\[hover-add\]`.
- JS/TS: ES6UnusedImports (the Svelte plugin cannot resolve
  `@lucide/svelte/icons/*` and calls all 122 icon imports unused; every
  tsconfig has noUnusedLocals, enforced by svelte-check and tsc), the
  admin's relative imports of the public app, `}` escapes kept for
  unicode-mode parsing, fetcher.ts's throw-to-own-catch fallback, and
  keyCode 229 for IME composition.
- Rust: CargoUnusedDependency, which cannot see the ::serde_json paths
  generate_context!() expands to.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:54:28 +07:00
poli0981andClaude Opus 5.5 11c38dba24 fix: the first Qodana findings
No behaviour changes; each is what the inspection asked, or the type
information it lacked.

Python (scripts/):
- `return (a, b)` -> `return a, b` (12, steam_client, store_items,
  backfill_discover).
- `log=print` parameters annotated `Callable[[str], None]`: PyCharm could
  not type the overloaded builtin as a default and called every log(...)
  "not callable" (10, budget, purge_unhealthy, refresh_anticheat,
  refresh_peaks).
- fetch_full()'s docstring names all its parameters.
- Nested helpers no longer shadow the loop variables of the function
  around them (purge_unhealthy judge(), update_reviews ask()).
- The leaderboards' bare `except:` catches what a reviews string can
  raise (AttributeError, TypeError, ValueError), not SystemExit and
  KeyboardInterrupt too.
- edit_game.py: unused `import json` dropped; mark_dead_games `[^\d]` ->
  `\D`; the DLC section regex loses a group around the whole pattern
  (only ever used with search()).

TypeScript / Svelte (web/):
- Two comma expressions written as statements (pipeline route's run
  dedupe, CandidateDialog's Reopen button).
- shouldIgnore() returns its last condition instead of if/return.
- Resource's constructor-only private fields are readonly.
- The admin mock seed says HOUR, not 1 * HOUR.

Rust (web/src-tauri/): `serde` dropped - nothing in the crate or in what
generate_context!() expands uses it (only `::serde_json` paths are
generated). serde_json stays, with a comment: Qodana calls it unused
too, but the generated code needs it and the crate does not compile
without it.

Checked: pytest 467, typecheck, vitest 747, knip, cargo test --lib.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:54:28 +07:00
poli0981andClaude Opus 5.5 a956c8e182 ci(qodana): one workflow, interpreter, Rust build deps, Svelte via Docker
What the first runs showed, and the changes:

- Python: SDKs.json was empty - native mode finds no interpreter by
  itself, and without one every `dict[int, str]` and `X | None` was an
  "invalid type hint" (11 of the 50 problems). The job now builds .venv
  from the hashed requirements and passes QODANA_PYTHON_PATH.
- Rust: "Analysis scope: 0 packages" and a Critical "Cargo project
  loading" sanity problem: the image has no C linker and none of
  Tauri's libraries, and runs as the runner's user, who can neither
  apt-get install nor write the image's CARGO_HOME. Now `-u root`,
  CARGO_HOME in the cached Qodana cache dir, and a bootstrap that
  installs the build packages.
- JS/TS: installing the Svelte plugin fails in native mode with every
  released CLI up to 2026.2.3 ("qodana.build.date system property must
  be set"; fixed upstream as QD-16701 on 2026-11-05, unreleased), so
  this project runs in the Qodana image, on the node_modules and
  generated files the job prepared.

One workflow (qodana.yml) with a job per project, as in
free-games-itchio-list: the token check covers all three, triggers skip
data and Markdown-only commits, no PR comment (annotations, Qodana
Cloud and the report artifact carry the results), --repository-root .
for the subdirectory projects, and each job keeps its own cache keys.
The qodana.yaml files use `exclude` and name their Qodana Cloud project.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:54:28 +07:00
poli0981andClaude Opus 5.5 629cb1df75 ci: Qodana scans for Python, JS/TS and Rust
Three workflows, one per Qodana Cloud project and token
(QODANA_TOKEN_PYTHON, QODANA_TOKEN_TS_JS, QODANA_TOKEN_RUST), each with
the qodana.yaml of its project directory:

- qodana-python.yml: Qodana for Python over scripts/, native mode on the
  runner's Python 3.15 with the hashed requirements installed.
- qodana-js.yml: Qodana for JS over web/, native mode on Node 26 after
  `npm ci --ignore-scripts` and `npm run build:admin`, with the Svelte
  plugin so .svelte files are read.
- qodana-rust.yml: Qodana for Rust (EAP, Docker only) over web/src-tauri/,
  with a stand-in web/dist so generate_context!() expands.

Each runs on pushes to main and pull requests that touch its files, and
by hand. The scan is skipped when its token is not available (forks,
Dependabot), as sonarcloud.yml does; the action is pinned by SHA, the
job's token can read contents and write only checks and PR comments, and
each workflow has its own cache keys so the three do not collide.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:54:27 +07:00
poli0981 d87bf4e2e6 Merge pull request #259 from poli0981/chore/deps-2026-11-17
chore(deps): npm minor/patch bumps, knip 6.45 tsconfig fix
2026-11-17 08:49:21 +07:00
poli0981andClaude Opus 5.5 810325d615 chore(deps): npm minor/patch bumps, knip 6.45 tsconfig fix
Dependabot's npm-minor-patch group (#256): @lucide/svelte 1.72.0,
bits-ui 2.21.0, knip 6.45.1, rollup-plugin-visualizer 7.1.3, vite 8.3.8,
wrangler 4.162.0 - all released at least four days ago.

#256 failed Web CI on knip: 6.45 follows tsconfig.json's `extends` and
reports "$app" (from "$app/tsconfig", which `svelte-kit sync` generates
into node_modules/$app) as an unlisted dependency - an error. It cannot
be taken back with ignoreDependencies: knip matches those against a
package name, and getPackageNameFromModuleSpecifier() returns nothing for
a specifier starting with "$", so the item is never compared (and "$app"
would be read as a regex anyway). knip.json now ignores unlisted
dependencies in tsconfig.json only (ignoreIssues). The export backlog and
the three configuration hints are unchanged from main.

Local proof: typecheck, 747 tests, build + verify-dist --web (18,911
pages, precache 177 entries, as live), cf:check, knip, Tauri build +
verify-dist --tauri.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:29:23 +07:00
poli0981 8cee0386b8 Merge pull request #257 from poli0981/dependabot/github_actions/actions-all-e1b239a0ba
build(deps): Bump SonarSource/sonarqube-scan-action from 8.4.1 to 8.5.0 in the actions-all group
2026-11-17 08:28:58 +07:00
poli0981 b5d49d27ef Merge pull request #255 from poli0981/dependabot/pip/pip-all-a355f7132d
build(deps): Bump coverage from 7.17.2 to 7.17.3 in the pip-all group
2026-11-17 08:28:54 +07:00
github-actions[bot] fa2d08d9c7 Auto update [2026-11-17] 2026-11-17 00:15:17 +00:00
github-actions[bot] 754432be7d Snapshot [2026-11-16] 2026-11-16 23:09:12 +00:00
github-actions[bot] 40e7e65a8a Refresh all-time peaks [2026-11-16] 2026-11-16 19:44:07 +00:00
dependabot[bot] 005f923c4f build(deps): Bump SonarSource/sonarqube-scan-action
Bumps the actions-all group with 1 update: [SonarSource/sonarqube-scan-action](https://github.com/sonarsource/sonarqube-scan-action).


Updates `SonarSource/sonarqube-scan-action` from 8.4.1 to 8.5.0
- [Release notes](https://github.com/sonarsource/sonarqube-scan-action/releases)
- [Commits](https://github.com/sonarsource/sonarqube-scan-action/compare/e805d875275f728fac1885b413934be6d7c63f65...59202af334b4ba7b5db01b701b8e79f8b3bef0f4)

---
updated-dependencies:
- dependency-name: SonarSource/sonarqube-scan-action
  dependency-version: 8.5.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions-all
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-16 19:27:32 +00:00
dependabot[bot] de59ad8780 build(deps): Bump coverage from 7.17.2 to 7.17.3 in the pip-all group
Bumps the pip-all group with 1 update: [coverage](https://github.com/coveragepy/coveragepy).


Updates `coverage` from 7.17.2 to 7.17.3
- [Release notes](https://github.com/coveragepy/coveragepy/releases)
- [Changelog](https://github.com/coveragepy/coveragepy/blob/main/CHANGES.rst)
- [Commits](https://github.com/coveragepy/coveragepy/compare/7.17.2...7.17.3)

---
updated-dependencies:
- dependency-name: coverage
  dependency-version: 7.17.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: pip-all
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-16 19:26:37 +00:00
github-actions[bot] 8b70220247 Refresh anti-cheat [2026-11-16] 2026-11-16 17:16:27 +00:00
github-actions[bot] 79e0fe0379 Refresh store data [2026-11-16] 2026-11-16 17:08:09 +00:00
github-actions[bot] 8c8a0d703c Update reviews [2026-11-16] 2026-11-16 06:07:46 +00:00
github-actions[bot] 6bd060b85c Ingest games [2026-11-16 05:16] 2026-11-16 05:16:49 +00:00
f2p-tracker-admin[bot] aec8524b3d queue: 13 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-16 05:15:26 +00:00
github-actions[bot] 338c7f5346 chore(data): mark dead games 2026-11-16 04:41:01 +00:00
github-actions[bot] e9569b6f59 Auto update [2026-11-16] 2026-11-16 00:18:31 +00:00
github-actions[bot] 38e0e1941b Snapshot [2026-11-15] 2026-11-15 23:09:57 +00:00
github-actions[bot] 11e7776ddb Refresh all-time peaks [2026-11-15] 2026-11-15 19:45:29 +00:00
github-actions[bot] cabc925381 Ingest games [2026-11-15 17:46] 2026-11-15 17:46:06 +00:00
f2p-tracker-admin[bot] 516946e140 queue: 3 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-15 17:45:33 +00:00
github-actions[bot] 6e6425dde4 Refresh store data [2026-11-15] 2026-11-15 17:05:39 +00:00
github-actions[bot] 3eb88db76d Ingest games [2026-11-15 07:32] 2026-11-15 07:32:15 +00:00
f2p-tracker-admin[bot] 9a68f5b0cd queue: 19 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-15 07:30:27 +00:00
github-actions[bot] 1ed30cc15c Update reviews [2026-11-15] 2026-11-15 07:15:19 +00:00
github-actions[bot] 8ef4a3ed79 Top offline [2026-11-15 07:11] 2026-11-15 07:11:28 +00:00
github-actions[bot] 943dddcc71 Top online [2026-11-15 03:57] 2026-11-15 03:57:14 +00:00
github-actions[bot] 6868b7062c Auto update [2026-11-15] 2026-11-15 00:16:24 +00:00
github-actions[bot] 87693dacd8 Snapshot [2026-11-14] 2026-11-14 23:08:55 +00:00
github-actions[bot] bb179a953d Refresh all-time peaks [2026-11-14] 2026-11-14 19:48:14 +00:00
github-actions[bot] 37e52ebc63 Refresh store data [2026-11-14] 2026-11-14 17:02:35 +00:00
github-actions[bot] 3eba2c74e0 Purge unhealthy [2026-11-14] 2026-11-14 07:08:53 +00:00
github-actions[bot] 8b0d069c3e Update reviews [2026-11-14] 2026-11-14 06:05:55 +00:00
github-actions[bot] a739b3f56e Ingest games [2026-11-14 05:18] 2026-11-14 05:18:12 +00:00
f2p-tracker-admin[bot] c9fd7d12ff queue: 30 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-14 05:15:26 +00:00
github-actions[bot] 987ed4c01d Auto update [2026-11-14] 2026-11-14 00:14:53 +00:00
github-actions[bot] a91952e602 Snapshot [2026-11-13] 2026-11-13 23:10:09 +00:00
github-actions[bot] 98e0350a8b Refresh all-time peaks [2026-11-13] 2026-11-13 19:45:18 +00:00
github-actions[bot] 7d27261e5b Refresh anti-cheat [2026-11-13] 2026-11-13 17:17:40 +00:00
github-actions[bot] 815b979e57 Refresh store data [2026-11-13] 2026-11-13 17:07:59 +00:00
github-actions[bot] 9d82fb1645 Purge unhealthy [2026-11-13] 2026-11-13 07:14:17 +00:00
github-actions[bot] 86d197d615 Update reviews [2026-11-13] 2026-11-13 06:06:22 +00:00
github-actions[bot] 9e5abacc52 Ingest games [2026-11-13 05:17] 2026-11-13 05:17:19 +00:00
f2p-tracker-admin[bot] 18fafbffe8 queue: 19 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-13 05:15:27 +00:00
github-actions[bot] b95e9a733e Top online [2026-11-13 03:57] 2026-11-13 03:57:22 +00:00
github-actions[bot] 06e15dfd7d Auto update [2026-11-13] 2026-11-13 00:14:59 +00:00
github-actions[bot] 3d074a9aab Snapshot [2026-11-12] 2026-11-12 23:08:58 +00:00
github-actions[bot] 1e78af5121 Refresh all-time peaks [2026-11-12] 2026-11-12 19:44:48 +00:00
github-actions[bot] d6107ea986 Refresh anti-cheat [2026-11-12] 2026-11-12 17:15:53 +00:00
github-actions[bot] 6e6df6db4f Refresh store data [2026-11-12] 2026-11-12 17:06:20 +00:00
github-actions[bot] da25638a76 Purge unhealthy [2026-11-12] 2026-11-12 07:09:53 +00:00
github-actions[bot] 4cf7871eb7 Update reviews [2026-11-12] 2026-11-12 06:06:33 +00:00
github-actions[bot] 4b1d916274 Ingest games [2026-11-12 05:16] 2026-11-12 05:16:57 +00:00
f2p-tracker-admin[bot] 0e64b5fa51 queue: 15 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-12 05:15:26 +00:00
github-actions[bot] e2162ef881 chore(data): mark dead games 2026-11-12 04:33:08 +00:00
github-actions[bot] 3e945c72ab Auto update [2026-11-12] 2026-11-12 00:15:50 +00:00
github-actions[bot] b193f2b8cf Snapshot [2026-11-11] 2026-11-11 23:09:35 +00:00
github-actions[bot] cee8483a2d Refresh all-time peaks [2026-11-11] 2026-11-11 19:45:22 +00:00
github-actions[bot] 94a0084fc7 Refresh anti-cheat [2026-11-11] 2026-11-11 17:19:12 +00:00
github-actions[bot] 871a3d548b Refresh store data [2026-11-11] 2026-11-11 17:08:22 +00:00
poli0981 27747be1ab Merge pull request #253 from poli0981/docs/maintenance-mode
docs: put the project in maintenance mode
2026-11-11 20:52:21 +07:00
poli0981andClaude Fable 5.2 fa8dbaf92b docs: put the project in maintenance mode
The project is stable: no new features, code changes only for security
advisories and runtime/dependency updates, and issues and pull requests
are for the data (add, correct, remove a game).

- README: status, build, quality, version, licence and runtime badges, a
  "Project status" section, and a data-first Contribute section
- CONTRIBUTING, SECURITY, Contact, the PR template and CLAUDE.md state
  the same policy
- Issue forms: add_game and edit_game are new; feature_request, feedback
  and off_topic are removed; blank issues are off (config.yml)
- About page: "Report something" links the five remaining forms

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 20:49:27 +07:00
github-actions[bot] 6c7c6e844e Purge unhealthy [2026-11-11] 2026-11-11 07:09:34 +00:00
github-actions[bot] d3fea36da1 Update reviews [2026-11-11] 2026-11-11 06:06:17 +00:00
github-actions[bot] f379690ade Ingest games [2026-11-11 05:17] 2026-11-11 05:17:15 +00:00
f2p-tracker-admin[bot] 4ef293abbf queue: 18 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-11 05:15:27 +00:00
github-actions[bot] 69707cebd7 Top online [2026-11-11 03:57] 2026-11-11 03:57:16 +00:00
github-actions[bot] 912ced10c1 Auto update [2026-11-11] 2026-11-11 00:15:15 +00:00
github-actions[bot] 5d69cd63d4 Snapshot [2026-11-10] 2026-11-10 23:08:38 +00:00
github-actions[bot] a9eee8ea37 Refresh all-time peaks [2026-11-10] 2026-11-10 19:45:44 +00:00
github-actions[bot] 5f95e71028 Refresh store data [2026-11-10] 2026-11-10 17:07:12 +00:00
github-actions[bot] fcd15d9dc6 Update reviews [2026-11-10] 2026-11-10 06:06:25 +00:00
github-actions[bot] 4df740762b Ingest games [2026-11-10 05:17] 2026-11-10 05:17:20 +00:00
f2p-tracker-admin[bot] 527e8c9ae0 queue: 19 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-10 05:15:27 +00:00
github-actions[bot] 45cafb9229 Auto update [2026-11-10] 2026-11-10 00:14:46 +00:00
github-actions[bot] cd9fa3f3fb Snapshot [2026-11-09] 2026-11-09 23:08:51 +00:00
poli0981 2999d00f1e Merge pull request #252 from poli0981/chore/changelog-deps-2026-11-10
docs(changelog): note the 2026-11-10 dependency pass
2026-11-10 05:45:04 +07:00
poli0981andClaude Fable 5.2 e85c0b7c3d docs(changelog): note the 2026-11-10 dependency pass
Dependabot #249 (coverage 7.17.2), #250 (action-gh-release 3.0.4,
sonarqube-scan-action 8.4.1) and #251 (twelve npm patch and minor
releases) were merged as they were. Nothing security-relevant, so the
entry waits in [Unreleased] for the next release.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-10 05:42:35 +07:00
poli0981 5f5d5aaacb Merge pull request #251 from poli0981/dependabot/npm_and_yarn/web/npm-minor-patch-b500c0a422
build(deps): Bump the npm-minor-patch group in /web with 12 updates
2026-11-10 05:41:21 +07:00
poli0981 b1b5cdbaf6 Merge pull request #250 from poli0981/dependabot/github_actions/actions-all-4335810fcd
build(deps): Bump the actions-all group with 2 updates
2026-11-10 05:35:48 +07:00
poli0981 c110fae122 Merge pull request #249 from poli0981/dependabot/pip/pip-all-eaae939d93
build(deps): Bump coverage from 7.17.0 to 7.17.2 in the pip-all group
2026-11-10 05:35:44 +07:00
github-actions[bot] 72dcf09f0d Refresh all-time peaks [2026-11-09] 2026-11-09 19:46:30 +00:00
dependabot[bot] be48842a48 build(deps): Bump the npm-minor-patch group in /web with 12 updates
Bumps the npm-minor-patch group in /web with 12 updates:

| Package | From | To |
| --- | --- | --- |
| [@lucide/svelte](https://github.com/lucide-icons/lucide/tree/HEAD/packages/svelte) | `1.66.0` | `1.70.0` |
| [@tanstack/svelte-virtual](https://github.com/TanStack/virtual/tree/HEAD/packages/svelte-virtual) | `3.13.50` | `3.13.52` |
| [bits-ui](https://github.com/huntabyte/bits-ui) | `2.20.2` | `2.20.6` |
| [svelte-sonner](https://github.com/wobsoriano/svelte-sonner) | `1.2.2` | `1.2.3` |
| [@tailwindcss/vite](https://github.com/tailwindlabs/tailwindcss/tree/HEAD/packages/@tailwindcss-vite) | `4.3.3` | `4.3.5` |
| [@vitest/coverage-v8](https://github.com/vitest-dev/vitest/tree/HEAD/packages/coverage-v8) | `5.0.5` | `5.1.0` |
| [rollup-plugin-visualizer](https://github.com/btd/rollup-plugin-visualizer) | `7.1.1` | `7.1.2` |
| [svelte-check](https://github.com/sveltejs/language-tools) | `4.7.7` | `4.7.8` |
| [tailwindcss](https://github.com/tailwindlabs/tailwindcss/tree/HEAD/packages/tailwindcss) | `4.3.3` | `4.3.5` |
| [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) | `8.3.5` | `8.3.6` |
| [vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest) | `5.0.5` | `5.1.0` |
| [wrangler](https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler) | `4.156.0` | `4.158.0` |


Updates `@lucide/svelte` from 1.66.0 to 1.70.0
- [Release notes](https://github.com/lucide-icons/lucide/releases)
- [Commits](https://github.com/lucide-icons/lucide/commits/1.70.0/packages/svelte)

Updates `@tanstack/svelte-virtual` from 3.13.50 to 3.13.52
- [Release notes](https://github.com/TanStack/virtual/releases)
- [Changelog](https://github.com/TanStack/virtual/blob/main/packages/svelte-virtual/CHANGELOG.md)
- [Commits](https://github.com/TanStack/virtual/commits/@tanstack/svelte-virtual@3.13.52/packages/svelte-virtual)

Updates `bits-ui` from 2.20.2 to 2.20.6
- [Release notes](https://github.com/huntabyte/bits-ui/releases)
- [Commits](https://github.com/huntabyte/bits-ui/compare/bits-ui@2.20.2...bits-ui@2.20.6)

Updates `svelte-sonner` from 1.2.2 to 1.2.3
- [Release notes](https://github.com/wobsoriano/svelte-sonner/releases)
- [Changelog](https://github.com/wobsoriano/svelte-sonner/blob/main/CHANGELOG.md)
- [Commits](https://github.com/wobsoriano/svelte-sonner/compare/v1.2.2...v1.2.3)

Updates `@tailwindcss/vite` from 4.3.3 to 4.3.5
- [Release notes](https://github.com/tailwindlabs/tailwindcss/releases)
- [Changelog](https://github.com/tailwindlabs/tailwindcss/blob/main/CHANGELOG.md)
- [Commits](https://github.com/tailwindlabs/tailwindcss/commits/v4.3.5/packages/@tailwindcss-vite)

Updates `@vitest/coverage-v8` from 5.0.5 to 5.1.0
- [Release notes](https://github.com/vitest-dev/vitest/releases)
- [Changelog](https://github.com/vitest-dev/vitest/blob/main/docs/releases.md)
- [Commits](https://github.com/vitest-dev/vitest/commits/v5.1.0/packages/coverage-v8)

Updates `rollup-plugin-visualizer` from 7.1.1 to 7.1.2
- [Changelog](https://github.com/btd/rollup-plugin-visualizer/blob/master/CHANGELOG.md)
- [Commits](https://github.com/btd/rollup-plugin-visualizer/compare/v7.1.1...v7.1.2)

Updates `svelte-check` from 4.7.7 to 4.7.8
- [Release notes](https://github.com/sveltejs/language-tools/releases)
- [Commits](https://github.com/sveltejs/language-tools/compare/svelte-check@4.7.7...svelte-check@4.7.8)

Updates `tailwindcss` from 4.3.3 to 4.3.5
- [Release notes](https://github.com/tailwindlabs/tailwindcss/releases)
- [Changelog](https://github.com/tailwindlabs/tailwindcss/blob/main/CHANGELOG.md)
- [Commits](https://github.com/tailwindlabs/tailwindcss/commits/v4.3.5/packages/tailwindcss)

Updates `vite` from 8.3.5 to 8.3.6
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v8.3.6/packages/vite)

Updates `vitest` from 5.0.5 to 5.1.0
- [Release notes](https://github.com/vitest-dev/vitest/releases)
- [Changelog](https://github.com/vitest-dev/vitest/blob/main/docs/releases.md)
- [Commits](https://github.com/vitest-dev/vitest/commits/v5.1.0/packages/vitest)

Updates `wrangler` from 4.156.0 to 4.158.0
- [Release notes](https://github.com/cloudflare/workers-sdk/releases)
- [Commits](https://github.com/cloudflare/workers-sdk/commits/wrangler@4.158.0/packages/wrangler)

---
updated-dependencies:
- dependency-name: "@lucide/svelte"
  dependency-version: 1.70.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: "@tanstack/svelte-virtual"
  dependency-version: 3.13.52
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: bits-ui
  dependency-version: 2.20.6
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: svelte-sonner
  dependency-version: 1.2.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tailwindcss/vite"
  dependency-version: 4.3.5
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@vitest/coverage-v8"
  dependency-version: 5.1.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: rollup-plugin-visualizer
  dependency-version: 7.1.2
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: svelte-check
  dependency-version: 4.7.8
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: tailwindcss
  dependency-version: 4.3.5
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: vite
  dependency-version: 8.3.6
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: vitest
  dependency-version: 5.1.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: wrangler
  dependency-version: 4.158.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-09 19:28:11 +00:00
dependabot[bot] e7c9d05e7c build(deps): Bump the actions-all group with 2 updates
Bumps the actions-all group with 2 updates: [softprops/action-gh-release](https://github.com/softprops/action-gh-release) and [SonarSource/sonarqube-scan-action](https://github.com/sonarsource/sonarqube-scan-action).


Updates `softprops/action-gh-release` from 3.0.3 to 3.0.4
- [Release notes](https://github.com/softprops/action-gh-release/releases)
- [Changelog](https://github.com/softprops/action-gh-release/blob/master/CHANGELOG.md)
- [Commits](https://github.com/softprops/action-gh-release/compare/efb35369e0ad2afab669f228072c1b0d510eae64...8a0cd651e5b2365bd640854a3fa5dfc70e4875f3)

Updates `SonarSource/sonarqube-scan-action` from 8.4.0 to 8.4.1
- [Release notes](https://github.com/sonarsource/sonarqube-scan-action/releases)
- [Commits](https://github.com/sonarsource/sonarqube-scan-action/compare/4d1dc0c91ee400dcf8a6dddf2f705ac36542e304...e805d875275f728fac1885b413934be6d7c63f65)

---
updated-dependencies:
- dependency-name: softprops/action-gh-release
  dependency-version: 3.0.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions-all
- dependency-name: SonarSource/sonarqube-scan-action
  dependency-version: 8.4.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions-all
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-09 19:27:42 +00:00
dependabot[bot] e9ee8e0dbb build(deps): Bump coverage from 7.17.0 to 7.17.2 in the pip-all group
Bumps the pip-all group with 1 update: [coverage](https://github.com/coveragepy/coveragepy).


Updates `coverage` from 7.17.0 to 7.17.2
- [Release notes](https://github.com/coveragepy/coveragepy/releases)
- [Changelog](https://github.com/coveragepy/coveragepy/blob/main/CHANGES.rst)
- [Commits](https://github.com/coveragepy/coveragepy/compare/7.17.0...7.17.2)

---
updated-dependencies:
- dependency-name: coverage
  dependency-version: 7.17.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: pip-all
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-09 19:26:40 +00:00
github-actions[bot] f989fa08b8 Refresh store data [2026-11-09] 2026-11-09 17:08:25 +00:00
poli0981 7e1db40c37 update accessibility docs test 2026-11-09 16:30:11 +07:00
github-actions[bot] 06a79264a5 Purge unhealthy [2026-11-09] 2026-11-09 07:10:08 +00:00
github-actions[bot] 658e6c854a Update reviews [2026-11-09] 2026-11-09 06:07:39 +00:00
github-actions[bot] 1cdce944ff Ingest games [2026-11-09 05:16] 2026-11-09 05:16:10 +00:00
f2p-tracker-admin[bot] 0789f9041f queue: 5 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-09 05:15:26 +00:00
github-actions[bot] 7092925a42 chore(data): mark dead games 2026-11-09 04:33:28 +00:00
poli0981 f16ef68269 Merge pull request #245 from poli0981/release/v4.7.1
release: v4.7.1 "Curb Cut" / apps 2.5.1
2026-11-09 09:23:43 +07:00
poli0981andClaude Opus 5.5 3830208e40 release: v4.7.1 "Curb Cut" / apps 2.5.1
The apps go from 2.5.0 to 2.5.1, which is the first app build with the
accessibility fixes from #244. The desktop app is also the first build that
can zoom.

Version bumps: web/package.json and its lock, src-tauri/Cargo.toml and the
f2p-tracker entry in Cargo.lock, and tauri.conf.json (Android's versionCode
derives from it).

The CHANGELOG's [Unreleased] section becomes v4.7.1, with an intro, and a
fresh [Unreleased] goes above it. ACCESSIBILITY.md now says what works for
the website and the apps 2.5.1, instead of "the apps get it with their next
release".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 09:20:46 +07:00
poli0981 4926c7ea00 Merge pull request #244 from poli0981/fix/a11y-barriers
fix(a11y): games table semantics, first-run dialogs, kernel cue, contrast, zoom
2026-11-09 09:10:43 +07:00
poli0981andClaude Opus 5.5 91f49d2cef test(a11y): cover the overlay state and the Ctrl/Cmd+K stand-down
SonarCloud's gate counted 6 new lines no test had loaded: the overlay state
and focusOnMount (lib/overlays.svelte.ts), and the palette shortcut's new
early return. overlays.test.ts drives them in Node: overlays.open follows
either overlay, focusOnMount focuses without scrolling, and Ctrl+K is left
alone under an overlay (palette shut, default not prevented) but toggles the
palette otherwise.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 09:07:46 +07:00
poli0981andClaude Opus 5.5 24fa8554e2 test(a11y): hold the fixes; ACCESSIBILITY.md, CLAUDE.md, CHANGELOG
src/lib/a11y.test.ts reads the source, like mobile-layout.test.ts. It
checks:
- the table's roles, counts and row indexes, and that no <a> is a row or
  carries a fake link;
- every column has a name, and the cards are a list with positions;
- the panes have a minimum height;
- there is no colour-only kernel badge;
- the overlays are dialogs that focus themselves and make the page inert;
- the palette shortcut stands down, and back-to-top is inert while hidden;
- the zoom setting and its capability are present.

It also computes the theme's contrast with the WCAG formula, so a token
edit that drops below 4.5:1 for text or 3:1 for a control's edge fails.

ACCESSIBILITY.md moves the fixed items from "Known limitations" to "What
works today". The desktop and Android apps 2.5.0 predate them and get them
with their next release. CLAUDE.md lists the rules behind each fix, and
CHANGELOG [Unreleased] describes them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 09:03:59 +07:00
poli0981andClaude Opus 5.5 946d097c56 fix(a11y): contrast in both themes; the desktop app can zoom
Computed with the WCAG formula, against the page, cards, and each colour's
own /12-/15 tint.

Light theme:
- Links, primary button labels, warnings and some badges measured
  3.2-4.3:1. --primary goes 42% -> 34% (with --ring), --warning
  38 -> 29, --destructive 47 -> 42, --success 32 -> 27 and --info 40 -> 35.
- --input goes from the --border value to 3.2:1, so text boxes and
  drop-downs show an edge. --border stays light; card edges carry no
  meaning.

Dark theme:
- --destructive 62 -> 67 brings red badges from 4.05 to 4.6.
- --input goes 19 -> 40% for the same 3:1 edge.

Desktop zoom: tauri.conf.json sets zoomHotkeysEnabled (Tauri's default is
false, which also turned off WebView2's zoom). capabilities/zoom.json, which
is desktop-only like updater.json, grants core:webview:allow-set-webview-zoom.
macOS and Linux zoom through a script Tauri injects that calls it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 09:03:59 +07:00
poli0981andClaude Opus 5.5 3423500494 fix(a11y): first-run screens are dialogs; the page behind them is inert
The terms screen was a plain div, rendered last in the page. Focus stayed
where it was, and Tab walked through the whole hidden page before reaching
its buttons. The human check had role="dialog", but neither moved focus
nor kept it.

Both now:
- report themselves to lib/overlays.svelte.ts;
- are role="dialog" with aria-modal, labelled by an h2 (each used to add a
  second h1);
- move focus into themselves on mount (focusOnMount).

The layout makes everything behind them inert: the bare pages' wrapper,
the skip link and the shell. BackToTop moves inside the shell to go inert
with it.

Ctrl/Cmd+K stands down while they are open. It could open the palette
UNDER the gate (z-50 against z-[60]) and trap focus there, out of sight.

Also:
- BackToTop is inert while hidden: it only faded out, so it stayed a Tab
  stop. Its JS smooth scroll follows prefers-reduced-motion.
- The command palette's search box gets a focus ring, drawn on its row.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 09:03:58 +07:00
poli0981andClaude Opus 5.5 e827ac83a7 fix(a11y): the games table is a table, the cards a list
The games table:
- The rows were <a role="row"> with nothing around them, so a screen reader
  read them as neither a link nor a table. The grid now has the complete
  ARIA table: role="table" with aria-rowcount/aria-colcount, a rowgroup,
  and aria-rowindex on every virtualised row. The icon-only columns have
  names for screen readers (srLabel), and the non-sortable "Platforms"
  header is plain text rather than a disabled button.
- A row is no longer a link wrapped around a fake one. The name is the
  row's only Tab stop, and its link stretches over the row, so a click
  anywhere still opens the game. The Steam icon is a real link, kept out
  of the Tab order (a game's page has the same links). The tooltips sit
  above the stretched link, and screen readers get their words.
- The row draws the focus ring, because the cells clip overflow.

The phone cards are a list with aria-setsize/aria-posinset.

Both panes keep a minimum height (min-h-64). Sized to the window alone,
they shrank to nothing at 300-400% zoom.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 09:03:58 +07:00
poli0981andClaude Opus 5.5 0f68351fb8 fix(a11y): kernel-level anti-cheat is shown by more than colour
Kernel-level anti-cheat differed from the rest only by its badge colour,
red against amber, with the product name as the only text. That told a
colour-blind reader and a screen reader nothing.

games/AntiCheatBadge.svelte adds a shield icon and the words
"Kernel-level". They are visible on a game's page, and read only by screen
readers where a long product name already fills the badge (/random here;
the table and the cards in the next commit).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 09:03:58 +07:00
poli0981 a858c6ed20 Merge pull request #243 from poli0981/docs/accessibility-statement
docs: accessibility statement, a11y issue form, PR template, community docs sync
2026-11-09 08:49:48 +07:00
poli0981andClaude Opus 5.5 2b4b988cc7 docs: sync the community docs with the repository
A read-through against the code found about forty claims that had drifted.

README:
- Dynamic game-count and version badges. The count is index.json's total.
  The version is the newest v* release by semver, since an app release
  published last would otherwise count as "latest".
- SvelteKit 3, every desktop package, and the shard layout without a last
  shard number.
- The media host, which commits deploy, and the nine workflows the table
  left out.
- The accessibility statement and form in the link lists.

SECURITY.md:
- Fix the broken bullet list.
- Describe the real stack, and pushes with the built-in GITHUB_TOKEN.
- Add to scope: the media host, /api/ingest/*, /api/updates/desktop and the
  avatar origin.

AUTHORS.md and username.txt:
- Donations are in FUNDING.yml.
- The Add-games template is gone.
- Test devices come from pc_spec.

The issue forms lose the hash URLs, the GitHub Pages permalink, and the
editing and GPG options.

web/README.md, dev_env (EN + VI), the acknowledgements and the contact page
are updated to match. The last two are not consent documents, so nobody is
asked to accept the terms again.

CHANGELOG [Unreleased] lists all three commits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 08:43:39 +07:00
poli0981andClaude Opus 5.5 1845834b98 fix(about): link the accessibility statement and form; true stack facts
The report section gets a fourth form, Accessibility barrier, in a 2x2
grid. Below it are a short note and a link to ACCESSIBILITY.md on GitHub.
The statement is linked rather than rendered under /legal/: it is not a
legal document, and a file rendered there becomes a build input that the
deploy watch paths must list.

The stack list said SvelteKit 2 and a 3,600-row table. The footnote said
everything the page loads comes from this site, which is not true of the
beacon or the human check. The Vietnamese AI note also gets the last
sentence it was missing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 08:43:39 +07:00
poli0981andClaude Opus 5.5 b5b8b4eb12 docs: an accessibility statement, its issue form and a PR template
ACCESSIBILITY.md sits at the root beside SECURITY.md. GitHub reads it from
.github/, the root or docs/ and shows it as the repository's Accessibility
tab. It covers:
- WCAG 2.2 AA as a target, not a claim.
- What works today and what does not, with a way around each limitation
  where there is one.
- The browsers, apps and assistive technology actually used (keyboard,
  Narrator, NVDA).
- How to report a barrier without saying anything about yourself.
- Replies on SECURITY.md's terms: first within a week, blockers first, no
  fixed deadlines.
- The rules for contributors and coding agents.

.github/ISSUE_TEMPLATE/accessibility.yml files a report under the new
`accessibility` label, with no required final checkbox. The pull request
template is the short checklist, and completes the community profile.
CLAUDE.md says the statement is a claim about the code, and names the two
limitations that look solved but are not.

.gitattributes keeps the new file out of source archives like the other
community files. It also stops leaving out Contact, PRIVACY_POLICY and ToS:
the web build reads every legal document and stops when one is missing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 08:43:33 +07:00
github-actions[bot] fc201981de Auto update [2026-11-09] 2026-11-09 00:16:40 +00:00
github-actions[bot] 5308f7b5ab Snapshot [2026-11-08] 2026-11-08 23:09:08 +00:00
github-actions[bot] 1c7afb773f Ingest games [2026-11-08 22:45] 2026-11-08 22:45:51 +00:00
f2p-tracker-admin[bot] 09bbbaa449 queue: 2 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-08 22:45:27 +00:00
github-actions[bot] 2dea52dd25 Refresh all-time peaks [2026-11-08] 2026-11-08 19:45:46 +00:00
github-actions[bot] 20490e2dab Refresh store data [2026-11-08] 2026-11-08 17:05:11 +00:00
github-actions[bot] bb0e225565 Purge unhealthy [2026-11-08] 2026-11-08 07:09:44 +00:00
github-actions[bot] c1707a858d Update reviews [2026-11-08] 2026-11-08 06:06:11 +00:00
github-actions[bot] 77109032f4 Ingest games [2026-11-08 05:16] 2026-11-08 05:16:36 +00:00
f2p-tracker-admin[bot] d94500bd29 queue: 11 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-08 05:15:26 +00:00
github-actions[bot] bf0a075d4e Top online [2026-11-08 03:57] 2026-11-08 03:57:12 +00:00
github-actions[bot] a7fce4ad1c Auto update [2026-11-08] 2026-11-08 00:17:06 +00:00
github-actions[bot] 453e7fafeb Snapshot [2026-11-07] 2026-11-07 23:08:46 +00:00
github-actions[bot] 516658c24f Refresh all-time peaks [2026-11-07] 2026-11-07 19:45:44 +00:00
github-actions[bot] bc117131e9 Refresh store data [2026-11-07] 2026-11-07 17:06:50 +00:00
github-actions[bot] 3f107e12d4 Purge unhealthy [2026-11-07] 2026-11-07 07:13:20 +00:00
github-actions[bot] 745f26fc54 Update reviews [2026-11-07] 2026-11-07 06:06:00 +00:00
github-actions[bot] 4fb66516f3 Ingest games [2026-11-07 05:17] 2026-11-07 05:17:56 +00:00
f2p-tracker-admin[bot] 3d2b5567d9 queue: 28 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-07 05:15:26 +00:00
github-actions[bot] 6907c44877 Auto update [2026-11-07] 2026-11-07 00:13:56 +00:00
github-actions[bot] 8c84a686f5 Snapshot [2026-11-06] 2026-11-06 23:08:35 +00:00
github-actions[bot] 7261c937db Refresh all-time peaks [2026-11-06] 2026-11-06 19:44:55 +00:00
github-actions[bot] f31d058ae3 Refresh store data [2026-11-06] 2026-11-06 17:12:25 +00:00
github-actions[bot] 7d0a37f0df Ingest games [2026-11-06 12:09] 2026-11-06 12:09:17 +00:00
f2p-tracker-admin[bot] ac89daad0b queue: 72 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 11:19:55 +00:00
f2p-tracker-admin[bot] 11d5c06177 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 11:11:40 +00:00
f2p-tracker-admin[bot] 944918f93a queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 11:06:33 +00:00
f2p-tracker-admin[bot] 7d82773873 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 10:46:12 +00:00
f2p-tracker-admin[bot] a9e34770c9 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 10:41:41 +00:00
github-actions[bot] 9d8926c7d3 Ingest games [2026-11-06 10:30] 2026-11-06 10:30:33 +00:00
f2p-tracker-admin[bot] 8bbc654447 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 10:22:12 +00:00
github-actions[bot] 997e29952a Ingest games [2026-11-06 10:04] 2026-11-06 10:04:14 +00:00
f2p-tracker-admin[bot] eec68b92d1 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 09:55:51 +00:00
github-actions[bot] e27ab05d5d Ingest games [2026-11-06 09:42] 2026-11-06 09:42:25 +00:00
f2p-tracker-admin[bot] e3d47103a6 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 09:34:04 +00:00
github-actions[bot] 98d908c44c Ingest games [2026-11-06 08:03] 2026-11-06 08:03:21 +00:00
f2p-tracker-admin[bot] 7b79ade258 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 07:54:55 +00:00
github-actions[bot] 1c00bc31a8 Purge unhealthy [2026-11-06] 2026-11-06 07:14:00 +00:00
github-actions[bot] 6fd15af40a Update reviews [2026-11-06] 2026-11-06 06:06:15 +00:00
github-actions[bot] c127a80e83 Top online [2026-11-06 03:54] 2026-11-06 03:54:56 +00:00
github-actions[bot] 636a355b84 Ingest games [2026-11-06 01:08] 2026-11-06 01:08:43 +00:00
f2p-tracker-admin[bot] 462e42f562 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 01:00:29 +00:00
github-actions[bot] ff11c14515 Ingest games [2026-11-06 00:53] 2026-11-06 00:53:40 +00:00
f2p-tracker-admin[bot] ed36ec0958 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 00:45:29 +00:00
github-actions[bot] 50490129c1 Ingest games [2026-11-06 00:38] 2026-11-06 00:38:55 +00:00
f2p-tracker-admin[bot] 46dcd75042 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 00:30:29 +00:00
github-actions[bot] aff9b1832b Ingest games [2026-11-06 00:23] 2026-11-06 00:23:47 +00:00
f2p-tracker-admin[bot] 48b3781ca2 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 00:15:28 +00:00
github-actions[bot] c544317cbb Auto update [2026-11-06] 2026-11-06 00:15:01 +00:00
github-actions[bot] 42907665f0 Ingest games [2026-11-06 00:08] 2026-11-06 00:08:57 +00:00
f2p-tracker-admin[bot] e5e1acfaa5 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-06 00:00:27 +00:00
github-actions[bot] 092593c1ad Snapshot [2026-11-05] 2026-11-05 23:10:12 +00:00
github-actions[bot] 7eba1d477d Refresh all-time peaks [2026-11-05] 2026-11-05 19:43:51 +00:00
github-actions[bot] 5e03fcf595 Refresh store data [2026-11-05] 2026-11-05 17:10:54 +00:00
github-actions[bot] b566610751 Update reviews [2026-11-05] 2026-11-05 06:05:55 +00:00
github-actions[bot] 7932220e10 chore(data): mark dead games 2026-11-05 04:33:38 +00:00
github-actions[bot] 0e4bd8f9d6 Ingest games [2026-11-05 01:08] 2026-11-05 01:08:53 +00:00
f2p-tracker-admin[bot] 7ffcb1355c queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-05 01:00:30 +00:00
github-actions[bot] efb4c52b05 Ingest games [2026-11-05 00:53] 2026-11-05 00:53:56 +00:00
f2p-tracker-admin[bot] ec4996d070 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-05 00:45:28 +00:00
github-actions[bot] 81a0ed8ca2 Ingest games [2026-11-05 00:38] 2026-11-05 00:38:42 +00:00
f2p-tracker-admin[bot] 25396fa380 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-05 00:30:29 +00:00
github-actions[bot] 45cfbc702b Ingest games [2026-11-05 00:23] 2026-11-05 00:23:49 +00:00
f2p-tracker-admin[bot] 576180b9c0 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-05 00:15:30 +00:00
github-actions[bot] 146f513431 Auto update [2026-11-05] 2026-11-05 00:14:47 +00:00
github-actions[bot] e5a7c67e7c Ingest games [2026-11-05 00:09] 2026-11-05 00:09:01 +00:00
f2p-tracker-admin[bot] 7277e061dc queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-05 00:00:27 +00:00
github-actions[bot] be4ae3cd7d Snapshot [2026-11-04] 2026-11-04 23:10:01 +00:00
github-actions[bot] 6c34c09fc1 Refresh all-time peaks [2026-11-04] 2026-11-04 19:45:22 +00:00
github-actions[bot] f284258e9c Refresh anti-cheat [2026-11-04] 2026-11-04 17:15:46 +00:00
github-actions[bot] 37e6c75edf Refresh store data [2026-11-04] 2026-11-04 17:05:25 +00:00
github-actions[bot] bf57ef4afa Purge unhealthy [2026-11-04] 2026-11-04 07:09:09 +00:00
github-actions[bot] a2b1269b08 Update reviews [2026-11-04] 2026-11-04 06:06:08 +00:00
github-actions[bot] 794890350f Top online [2026-11-04 03:52] 2026-11-04 03:52:03 +00:00
github-actions[bot] 7654949ef5 Ingest games [2026-11-04 01:08] 2026-11-04 01:08:50 +00:00
f2p-tracker-admin[bot] 0e4dd40873 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-04 01:00:29 +00:00
github-actions[bot] 209e20f13e Ingest games [2026-11-04 00:53] 2026-11-04 00:53:45 +00:00
f2p-tracker-admin[bot] ec73dc84f8 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-04 00:45:29 +00:00
github-actions[bot] 15e715d19f Ingest games [2026-11-04 00:38] 2026-11-04 00:38:47 +00:00
f2p-tracker-admin[bot] 96faa3c63f queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-04 00:30:28 +00:00
github-actions[bot] 6d5fca0f50 Ingest games [2026-11-04 00:27] 2026-11-04 00:27:21 +00:00
f2p-tracker-admin[bot] 382d33e881 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-04 00:15:29 +00:00
github-actions[bot] 009dc03cea Auto update [2026-11-04] 2026-11-04 00:15:03 +00:00
github-actions[bot] 8128d3177b Ingest games [2026-11-04 00:09] 2026-11-04 00:09:00 +00:00
f2p-tracker-admin[bot] c51c74ef14 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-04 00:00:27 +00:00
github-actions[bot] f3476ae9e4 Snapshot [2026-11-03] 2026-11-03 23:09:29 +00:00
github-actions[bot] 2b339df9bb Refresh all-time peaks [2026-11-03] 2026-11-03 19:47:37 +00:00
github-actions[bot] adb08a4301 Refresh store data [2026-11-03] 2026-11-03 17:07:57 +00:00
poli0981 ce2e1e014b Merge pull request #239 from poli0981/feat/random-games-leave
v4.7.0 Lucky Dip: random games page, Leave site, Decline quits the apps
2026-11-03 19:33:52 +07:00
poli0981andClaude Opus 5.5 b6e45d86ef release: v4.7.0 "Lucky Dip" / apps 2.5.0
Desktop and Android 2.4.1 -> 2.5.0 (package.json and its lock,
tauri.conf.json, Cargo.toml, the f2p-tracker entry of Cargo.lock); repo
public-facing version 4.6.1 -> 4.7.0. CHANGELOG: the random games page,
Leave site, Decline quitting the Android app, and the 2026-11-03
dependency pass that waited in [Unreleased]. No legal document changed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 19:27:56 +07:00
poli0981andClaude Opus 5.5 4c987036e2 docs: random games and Leave site
CLAUDE.md: why /random keeps its picks in memory and only the reader
rolls, the crypto sampling (not Math.random), why the route is top-level,
and the base key a plural needs; how Leave site finds the page before the
site, the watchdog and its three cancel events, the deliberate second click
to close, and why Decline quits through exit(). Both READMEs list the
random page and its modules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 19:27:56 +07:00
poli0981andClaude Opus 5.5 5981c24bcd feat(consent): Leave site on the terms screen; Decline quits the apps
Web: a "Leave site" button on the terms card and on the declined notice.
No page may open the browser's own start page (chrome://newtab,
about:home), so lib/leave-site.ts goes back to the page before the site:
history.go(-(navigation.currentEntry.index + 1)) steps over every entry of
the site's contiguous same-origin run at once. history.go() is silent when
there is nowhere to go, so a 1.5 s watchdog (cancelled by beforeunload,
pagehide and popstate) shows "Nothing to go back to"; when every entry is
the site's that shows at once, and closing the tab is a second, explicit
click, because closing the last tab closes the browser window.

Apps: Decline called getCurrentWindow().close(), which on Android resolves
without closing anything (tao reports a destroyed window only from the
Activity's onDestroy), so Decline did nothing there. It now calls exit()
from @tauri-apps/api/app, which finishes the activity on Android and ends
the process on the desktop; the declined notice appears if the app is
still alive 2 s later. default.json trades core:window:allow-close, which
nothing else used, for core:app:allow-exit. The Leave button is web only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 19:27:44 +07:00
poli0981andClaude Opus 5.5 69c8964842 feat(web): random games page
/random rolls one to five games from the catalogue (five to start with):
any type, online or offline, dead games only when asked, never one marked
unsafe. Roll again avoids the games on screen while enough others remain;
a smaller count keeps the first picks, a larger one adds to them.

- lib/random-pick.ts: crypto.getRandomValues with rejection sampling and a
  sparse Fisher-Yates, never Math.random (SonarCloud S2245), plus the pool
  rules, read off appidIndex so each game appears once.
- lib/random.svelte.ts: the picks as appids, module-level and memory only,
  so Back from a game keeps them and no f2p:* key is needed (a new key
  means a privacy-policy edit, which reopens the consent gate). Only the
  reader rolls; a revalidation only drops a pick that left the catalogue
  or stopped qualifying.
- The page, an entry in the sidebar, drawer and palette (nav.ts) and a
  dashboard button. Top-level on purpose: the header search, isActive and
  the PWA's globIgnores all treat /games/* specially. The empty state joins
  verify-dist's BAKED_EMPTY_STATES; the sitemap ranks the page low.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 19:27:31 +07:00
github-actions[bot] 751898ed08 Ingest games [2026-11-03 11:13] 2026-11-03 11:13:31 +00:00
f2p-tracker-admin[bot] cbf87cb5c3 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 11:05:09 +00:00
github-actions[bot] 4140caa9df Ingest games [2026-11-03 11:00] 2026-11-03 11:00:10 +00:00
f2p-tracker-admin[bot] 73866bfccb queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 10:51:49 +00:00
github-actions[bot] f8607ac189 Ingest games [2026-11-03 09:31] 2026-11-03 09:31:50 +00:00
f2p-tracker-admin[bot] a94ed09c6a queue: 100 approved games
Approved in /admin by admin.

Reason: Pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 09:23:35 +00:00
github-actions[bot] d11fd4e0bf Ingest games [2026-11-03 08:39] 2026-11-03 08:39:34 +00:00
f2p-tracker-admin[bot] 94c7235de9 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 08:31:11 +00:00
github-actions[bot] 42d1008086 Ingest games [2026-11-03 07:48] 2026-11-03 07:48:05 +00:00
f2p-tracker-admin[bot] bc4415a715 queue: 100 approved games
Approved in /admin by admin.

Reason: pass

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 07:39:47 +00:00
github-actions[bot] 5fc6659395 Purge unhealthy [2026-11-03] 2026-11-03 07:16:15 +00:00
github-actions[bot] 9091ea56d1 Ingest games [2026-11-03 07:12] 2026-11-03 07:12:37 +00:00
f2p-tracker-admin[bot] 94ab4cb180 queue: 100 approved games
Approved in /admin by admin.

Reason: passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 07:04:21 +00:00
github-actions[bot] c68dba6ca0 Ingest games [2026-11-03 06:18] 2026-11-03 06:18:59 +00:00
f2p-tracker-admin[bot] ab8a6562b6 queue: 100 approved games
Approved in /admin by admin.

Reason: passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 06:10:40 +00:00
github-actions[bot] b7a9456afe Update reviews [2026-11-03] 2026-11-03 06:05:52 +00:00
github-actions[bot] 3b5058c854 Ingest games [2026-11-03 05:42] 2026-11-03 05:42:26 +00:00
f2p-tracker-admin[bot] 808461198a queue: 100 approved games
Approved in /admin by admin.

Reason: passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 05:34:04 +00:00
github-actions[bot] d61ca134f2 Ingest games [2026-11-03 02:46] 2026-11-03 02:46:24 +00:00
f2p-tracker-admin[bot] 4ec4b15306 queue: 50 approved games
Approved in /admin by admin.

Reason: passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 02:42:07 +00:00
poli0981 601083a061 Merge pull request #238 from poli0981/chore/deps-2026-11-03
chore(deps): npm + cargo minor/patch updates, drop the undici override
2026-11-03 09:09:57 +07:00
poli0981andClaude Opus 5.5 fd55963681 chore(deps): npm and cargo minor/patch updates, drop the undici override
Takes Dependabot's npm group (#236) and cargo group (#234) together: the
Tauri shell plugin moves to 2.6.0 on both sides, and the CLI refuses a
JavaScript/Rust pair on different minors. Adds the SvelteKit 3.1.1 and
adapter-static 4.0.1 patches (exact pins kept), @types/node 26.6.6, knip
6.44.1 and @lucide/svelte 1.66.0 - everything at least three days old;
newer releases wait for next week's Dependabot run.

wrangler 4.156.0's miniflare pins undici 7.30.1 itself, so the
"miniflare": {"undici": "^7.30.1"} override goes in the same commit, as
CLAUDE.md required. npm audit: only the known deepmerge low advisory.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 09:06:40 +07:00
poli0981 6baf4d3f24 Merge pull request #235 from poli0981/dependabot/pip/pip-all-625ba24d0e
build(deps): Bump pytest from 9.1.1 to 9.2.0 in the pip-all group
2026-11-03 08:56:54 +07:00
poli0981 8cb5f1dbd8 Merge pull request #237 from poli0981/dependabot/github_actions/actions-all-a5fe54a6d1
build(deps): Bump SonarSource/sonarqube-scan-action from 8.3.0 to 8.4.0 in the actions-all group
2026-11-03 08:56:50 +07:00
poli0981 0515afb03a Merge branch 'main' into dependabot/github_actions/actions-all-a5fe54a6d1 2026-11-03 08:49:29 +07:00
github-actions[bot] 0a4623d8e5 Ingest games [2026-11-03 01:08] 2026-11-03 01:08:48 +00:00
f2p-tracker-admin[bot] c6e43ea854 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 01:00:30 +00:00
github-actions[bot] 62beafe7df Ingest games [2026-11-03 00:53] 2026-11-03 00:53:49 +00:00
f2p-tracker-admin[bot] bd7de99f89 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 00:45:31 +00:00
github-actions[bot] 17ac380d39 Ingest games [2026-11-03 00:38] 2026-11-03 00:38:44 +00:00
f2p-tracker-admin[bot] 8296757a21 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 00:30:30 +00:00
github-actions[bot] b12a379e0a Ingest games [2026-11-03 00:24] 2026-11-03 00:24:06 +00:00
f2p-tracker-admin[bot] 8ee25f6463 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 00:15:29 +00:00
github-actions[bot] ead9e59dc7 Auto update [2026-11-03] 2026-11-03 00:14:00 +00:00
github-actions[bot] 0eed25cf23 Ingest games [2026-11-03 00:09] 2026-11-03 00:09:14 +00:00
f2p-tracker-admin[bot] 6413ea11eb queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-03 00:00:31 +00:00
github-actions[bot] b8e348013a Snapshot [2026-11-02] 2026-11-02 23:09:37 +00:00
github-actions[bot] 41a26eab0c Refresh all-time peaks [2026-11-02] 2026-11-02 19:42:47 +00:00
dependabot[bot] 984bc6ef12 build(deps): Bump SonarSource/sonarqube-scan-action
Bumps the actions-all group with 1 update: [SonarSource/sonarqube-scan-action](https://github.com/sonarsource/sonarqube-scan-action).


Updates `SonarSource/sonarqube-scan-action` from 8.3.0 to 8.4.0
- [Release notes](https://github.com/sonarsource/sonarqube-scan-action/releases)
- [Commits](https://github.com/sonarsource/sonarqube-scan-action/compare/d209202bc7d53ff1cc128f7f907dac145c9d6ae9...4d1dc0c91ee400dcf8a6dddf2f705ac36542e304)

---
updated-dependencies:
- dependency-name: SonarSource/sonarqube-scan-action
  dependency-version: 8.4.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions-all
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-02 19:28:37 +00:00
dependabot[bot] 9cc83da353 build(deps): Bump pytest from 9.1.1 to 9.2.0 in the pip-all group
Bumps the pip-all group with 1 update: [pytest](https://github.com/pytest-dev/pytest).


Updates `pytest` from 9.1.1 to 9.2.0
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/pytest/compare/9.1.1...9.2.0)

---
updated-dependencies:
- dependency-name: pytest
  dependency-version: 9.2.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: pip-all
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-02 19:26:48 +00:00
github-actions[bot] a4cc762af8 Refresh store data [2026-11-02] 2026-11-02 17:11:18 +00:00
github-actions[bot] afa572171b Update reviews [2026-11-02] 2026-11-02 06:07:16 +00:00
github-actions[bot] 6efedfc97f chore(data): mark dead games 2026-11-02 04:33:11 +00:00
github-actions[bot] bf40744f95 Ingest games [2026-11-02 01:23] 2026-11-02 01:23:47 +00:00
f2p-tracker-admin[bot] d4bf1d03ff queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-02 01:15:33 +00:00
github-actions[bot] 503d37647c Ingest games [2026-11-02 01:08] 2026-11-02 01:08:51 +00:00
f2p-tracker-admin[bot] 1ab7d39007 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-02 01:00:30 +00:00
github-actions[bot] 30f27e9675 Ingest games [2026-11-02 00:53] 2026-11-02 00:53:51 +00:00
f2p-tracker-admin[bot] fe53834d91 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-02 00:45:28 +00:00
github-actions[bot] 8af6ea054a Ingest games [2026-11-02 00:38] 2026-11-02 00:38:46 +00:00
f2p-tracker-admin[bot] b84c999b0a queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-02 00:30:30 +00:00
github-actions[bot] aff1abf293 Auto update [2026-11-02] 2026-11-02 00:15:49 +00:00
github-actions[bot] 5fe9d43ea6 Ingest games [2026-11-02 00:08] 2026-11-02 00:08:55 +00:00
f2p-tracker-admin[bot] d6e46078d1 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-02 00:00:27 +00:00
github-actions[bot] 43d747de6d Snapshot [2026-11-01] 2026-11-01 23:09:04 +00:00
github-actions[bot] 82a885131e Refresh all-time peaks [2026-11-01] 2026-11-01 19:43:08 +00:00
github-actions[bot] efd4179901 Refresh anti-cheat [2026-11-01] 2026-11-01 17:12:14 +00:00
github-actions[bot] 1c619d798a Refresh store data [2026-11-01] 2026-11-01 17:05:25 +00:00
github-actions[bot] cecd7d6df3 Update reviews [2026-11-01] 2026-11-01 06:45:16 +00:00
github-actions[bot] d057475617 Top offline [2026-11-01 06:42] 2026-11-01 06:42:18 +00:00
github-actions[bot] 6310d193a7 Ingest games [2026-11-01 04:10] 2026-11-01 04:10:15 +00:00
f2p-tracker-admin[bot] 1b87e62141 queue: 100 approved games
Approved in /admin by admin.

Reason: Passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-01 04:01:57 +00:00
github-actions[bot] 01bace2a47 Top online [2026-11-01 03:47] 2026-11-01 03:47:07 +00:00
github-actions[bot] 547fcb6ac3 Ingest games [2026-11-01 02:41] 2026-11-01 02:41:19 +00:00
f2p-tracker-admin[bot] 1ce8df827e queue: 100 approved games
Approved in /admin by admin.

Reason: passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-01 02:33:08 +00:00
github-actions[bot] 9fecd8e861 Ingest games [2026-11-01 01:08] 2026-11-01 01:08:45 +00:00
f2p-tracker-admin[bot] 447fd367d3 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-01 01:00:31 +00:00
github-actions[bot] 6235bb0751 Ingest games [2026-11-01 00:53] 2026-11-01 00:53:41 +00:00
f2p-tracker-admin[bot] cd8fa5995c queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-01 00:45:30 +00:00
github-actions[bot] 750ca5d929 Ingest games [2026-11-01 00:38] 2026-11-01 00:38:50 +00:00
f2p-tracker-admin[bot] 849d6ebf1a queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-01 00:30:29 +00:00
github-actions[bot] 3c413070a3 Auto update [2026-11-01] 2026-11-01 00:25:26 +00:00
github-actions[bot] 785fe53d2f Ingest games [2026-11-01 00:23] 2026-11-01 00:23:58 +00:00
f2p-tracker-admin[bot] 214c3bcaab queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-01 00:15:29 +00:00
github-actions[bot] 4458baadd0 Ingest games [2026-11-01 00:08] 2026-11-01 00:08:38 +00:00
f2p-tracker-admin[bot] 9d413fce93 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-11-01 00:00:27 +00:00
github-actions[bot] 61bf23d8f7 Snapshot [2026-10-31] 2026-10-31 23:08:42 +00:00
github-actions[bot] 296eb6d0ed Ingest games [2026-10-31 23:01] 2026-10-31 23:01:45 +00:00
f2p-tracker-admin[bot] b7458067e7 queue: 100 approved games
Approved in /admin by admin.

Reason: Passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 22:53:25 +00:00
github-actions[bot] 23ee0bf0e5 Ingest games [2026-10-31 22:27] 2026-10-31 22:27:03 +00:00
f2p-tracker-admin[bot] 98af94032b queue: 100 approved games
Approved in /admin by admin.

Reason: Passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 22:18:46 +00:00
github-actions[bot] 5fa6763867 Ingest games [2026-10-31 20:39] 2026-10-31 20:39:43 +00:00
f2p-tracker-admin[bot] c6bd7e6d3d queue: 100 approved games
Approved in /admin by admin.

Reason: Passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 20:31:22 +00:00
github-actions[bot] 30fc466581 Ingest games [2026-10-31 19:55] 2026-10-31 19:55:03 +00:00
f2p-tracker-admin[bot] dcb3dafae3 queue: 100 approved games
Approved in /admin by admin.

Reason: Passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 19:46:50 +00:00
github-actions[bot] 059e9a0591 Refresh all-time peaks [2026-10-31] 2026-10-31 19:40:58 +00:00
github-actions[bot] 2f5e9e4d35 Refresh store data [2026-10-31] 2026-10-31 17:31:38 +00:00
poli0981 732513082d Merge pull request #230 from poli0981/chore/deps-security-2026-10-31
v4.6.1 "Zip Tie": zip 9 in the desktop updater, patched glob and minimatch
2026-10-31 16:45:10 +07:00
poli0981andClaude Opus 5.5 7c0792b0ec release: v4.6.1 "Zip Tie" / apps 2.4.1
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-31 16:41:03 +07:00
poli0981andClaude Opus 5.5 6026a8870e fix(deps): zip 9 in the desktop updater, patched glob and minimatch
- tauri-plugin-updater 2.14.0 -> 2.14.1 moves its Windows zip reader from
  zip 4.6.1 to 9.2.0: closes Dependabot #82 (critical), #83, #84 and
  RUSTSEC-2026-0367/0368/0369. Targeted cargo update; cargo test --lib ok.
- npm overrides workbox-build -> glob ^14.0.2 and filelist -> minimatch
  ^11.0.1 (GHSA-3g3m-2fjr-6pw4, GHSA-g3hv-75wg-m249, published 2026-10-30).
  The precache lists the same 172 URLs as before.
- deepmerge (#81, low) has no fixed release: build-time only, dismissed.
- CLAUDE.md: when the new overrides and the undici one can go.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-31 16:40:24 +07:00
github-actions[bot] 0cf05a09c6 Purge unhealthy [2026-10-31] 2026-10-31 07:07:40 +00:00
github-actions[bot] c91b7181b8 Ingest games [2026-10-31 06:43] 2026-10-31 06:43:57 +00:00
f2p-tracker-admin[bot] 7f5e1761c1 queue: 29 approved games
Approved in /admin by admin.

Reason: Passed

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 06:41:17 +00:00
github-actions[bot] 7992ee6eb9 Update reviews [2026-10-31] 2026-10-31 06:05:08 +00:00
github-actions[bot] 6ccefd9a8f Ingest games [2026-10-31 01:08] 2026-10-31 01:08:49 +00:00
f2p-tracker-admin[bot] 2d3e8ffc4e queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 01:00:29 +00:00
github-actions[bot] 04594bdd8f Ingest games [2026-10-31 00:53] 2026-10-31 00:53:48 +00:00
f2p-tracker-admin[bot] 012498f419 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 00:45:29 +00:00
github-actions[bot] 491b3e6444 Ingest games [2026-10-31 00:38] 2026-10-31 00:38:47 +00:00
f2p-tracker-admin[bot] 6899d6968d queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 00:30:28 +00:00
github-actions[bot] d19adfb58f Ingest games [2026-10-31 00:23] 2026-10-31 00:23:51 +00:00
f2p-tracker-admin[bot] 28f966364e queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 00:15:30 +00:00
github-actions[bot] f1317bc1cc Auto update [2026-10-31] 2026-10-31 00:13:26 +00:00
github-actions[bot] 49ed8b4b22 Ingest games [2026-10-31 00:08] 2026-10-31 00:08:48 +00:00
f2p-tracker-admin[bot] 0737853c2e queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-31 00:00:27 +00:00
github-actions[bot] 948d408f34 Snapshot [2026-10-30] 2026-10-30 23:09:38 +00:00
github-actions[bot] 58e7668bc3 Refresh all-time peaks [2026-10-30] 2026-10-30 19:41:38 +00:00
github-actions[bot] 387f41df69 Refresh store data [2026-10-30] 2026-10-30 17:33:32 +00:00
f2p-tracker-admin[bot] 5c773d1404 override: Arknights: Endfield (genre, type_game)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-10-30 14:40:04 +00:00
f2p-tracker-admin[bot] 673ec46524 override: Stella Sora (type_game)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-10-30 14:35:54 +00:00
f2p-tracker-admin[bot] 5a5331814a override: Stella Sora (anti_cheat, is_kernel_ac, anti_cheat_note)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-10-30 14:33:34 +00:00
poli0981 5310cf355d Merge pull request #226 from poli0981/feat/all-languages
v4.6.0 "Polyglot": games in every language
2026-10-30 17:45:41 +07:00
poli0981andClaude Opus 5.5 bca818ee19 fix(pipeline): "Free To Play" is not a genre
appdetails writes "Free To Play"; SKIP_GENRE_TAGS said "Free to Play", and
the exact match let 1,357 of 12,854 games be stored with it as their genre
(the third most common), while the fallback to the first name could pick
it as well.

- fetcher.pick_genre() compares casefolded and never falls back to a price
  model or a release state (NOT_GENRES); with nothing else it says
  "Uncategorized". ingest uses it.
- Refresh Store Data replaces a stored one from appdetails: 150 games a
  day, first after the page repairs, never under an override. It is the one
  manual-field value the job writes; no person chose it. A dry run on the
  first 150 (2026-10-30): Casual 91, Indie 24, Strategy 11, Simulation 11,
  Uncategorized 10, three others; all answered, no override.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:43:03 +07:00
poli0981andClaude Opus 5.5 9ff338c734 release: v4.6.0 "Polyglot" / apps 2.4.0
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:29:17 +07:00
poli0981andClaude Opus 5.5 a618aeae2f docs: games in every language
- docs/plan/19-all-languages.md: what kept them out, what every workflow
  does with them, the re-sweep, and what is left.
- CLAUDE.md: discovery's language rules, ASCII appids, search folds but
  storage never does, re-cut descriptions are not news.
- docs/ADMIN.md: the filters as they are now, re-sweeping a whole year,
  the Languages line in the candidate dialog.
- README.md, docs/plan/11 (the decision changed), CHANGELOG [Unreleased].

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:28:47 +07:00
poli0981andClaude Opus 5.5 51b7da62b6 fix(web): CSV downloads open in Excel with CJK names intact
Without a byte order mark Excel reads a CSV in the system's legacy code
page, Japanese Windows included, and every Japanese, Chinese or Korean
name came out as mojibake. csvForExcel() prepends the mark; JSON is
unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:28:46 +07:00
poli0981andClaude Opus 5.5 8d644a9fbc feat(web): language filter, and search across scripts and widths
The catalogue now holds games in every language.

- /games filters by language (?lang=, counted like the others); the names
  are Steam's English ones as stored, data rather than i18n keys. About
  says the catalogue covers every language.
- fold() (NFKC, then hiragana to katakana) on both sides of every search
  box - the Fuse index (one getFn per key: the default getter hands back
  objects for array fields), the palette, /developers, /publishers and
  the anti-cheat list - so half-width, full-width, hiragana and katakana
  match. Search only: stored text keeps its spelling.
- The palette takes one kanji, kana or Hangul syllable.
- The header search waits for an input method to finish composing before
  it jumps to /games, and jumps with reset: false: the default reset sent
  focus to <body>, so the next keystroke went nowhere.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:28:46 +07:00
poli0981andClaude Opus 5.5 f91ad37e5b fix(pipeline): ASCII appids and CJK-aware description cuts
- Python's digit class also takes full-width and other scripts' digits.
  A queued link in them gave an appid that missed every comparison and
  made rotation.slice_of() raise, stopping every refresh. extract_appid
  refuses a run of digits with a non-ASCII one in it; normalize_link()
  reads NFKC first, so a Japanese keyboard's full-width appid is ASCII.
  The blocklist uses ASCII digits and fullmatch, like removal.ts.
- truncate_description() backs off to just after a CJK sentence end as it
  does to a space, and trims the CJK comma and full stop before the
  ellipsis. Stored descriptions (all within the cap) never change, and
  _fuller_cut() lets Refresh Store Data write a re-cut without calling it
  news.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:28:28 +07:00
poli0981andClaude Opus 5.5 7aef442b38 feat(admin): show a candidate's languages
The candidate dialog lists the languages discovery recorded, with a
"No English" badge when English is not among them. A row queued before
discovery recorded languages shows "-", which is not the same as an
empty list (a game that declares none). Auto-approve is unchanged: such
a game is decided like any other.

The mock server's payloads carry languages too, and it queues one game
without English so the badge can be seen in dev.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:28:28 +07:00
poli0981andClaude Opus 5.5 4672f871b3 ci(discovery): queue waiting runs and sweep a whole year
Every window swept before needs one more pass for the games without
English, and backfill windows are dispatched several at a time. The
discovery group kept ONE waiting run, so a third cancelled the one
already waiting - the lesson data-write learned in October.

- queue: max in both discovery workflows; pipeline.test.ts now holds
  every shared concurrency group to one queue setting.
- Backfill Discovery takes max_pages (through env, default 40): a whole
  recent year is about 30 pages of 100.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:28:27 +07:00
poli0981andClaude Opus 5.5 6f6eb3a71f feat(discovery): propose free games in every language
The store search pinned supportedlang=english, which left out every free
game that does not list English: 1,592 of 18,790 on 2026-10-30, most of
them Chinese, Japanese or Korean only (5118700 among them). Without the
parameter Steam filters on no language at all, with l=english or an
Accept-Language: ja header alike.

- fetch_search_page() sends no supportedlang, and sends l=english so the
  row text ("Coming soon", month names) stays English by parameter.
- Candidates carry their languages (appdetails_languages()), a dry run
  says which list no English, and every run counts them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:28:10 +07:00
github-actions[bot] 60b710a646 Purge unhealthy [2026-10-30] 2026-10-30 07:13:30 +00:00
github-actions[bot] cf3d408c60 Update reviews [2026-10-30] 2026-10-30 06:06:00 +00:00
github-actions[bot] 1b8de93d22 Top online [2026-10-30 03:44] 2026-10-30 03:44:24 +00:00
github-actions[bot] 9ced33939e Ingest games [2026-10-30 01:08] 2026-10-30 01:08:46 +00:00
f2p-tracker-admin[bot] 24bcfdc105 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-30 01:00:28 +00:00
github-actions[bot] 24382275e8 Ingest games [2026-10-30 00:53] 2026-10-30 00:53:50 +00:00
f2p-tracker-admin[bot] 321a199ca7 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-30 00:45:29 +00:00
github-actions[bot] 10888fc9b7 Ingest games [2026-10-30 00:38] 2026-10-30 00:38:45 +00:00
f2p-tracker-admin[bot] 63967fc542 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-30 00:30:30 +00:00
github-actions[bot] 849e00621c Auto update [2026-10-30] 2026-10-30 00:25:05 +00:00
github-actions[bot] 92a54e5c97 Ingest games [2026-10-30 00:23] 2026-10-30 00:23:47 +00:00
f2p-tracker-admin[bot] 1e0f607221 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-30 00:15:29 +00:00
github-actions[bot] a24f7d8fc6 Ingest games [2026-10-30 00:08] 2026-10-30 00:08:51 +00:00
f2p-tracker-admin[bot] 05c251cd65 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-30 00:00:26 +00:00
github-actions[bot] 2a4d754f0b Snapshot [2026-10-29] 2026-10-29 23:11:19 +00:00
github-actions[bot] 4f40f6a6ea Refresh all-time peaks [2026-10-29] 2026-10-29 19:41:23 +00:00
github-actions[bot] d8719adfe1 Refresh store data [2026-10-29] 2026-10-29 17:27:46 +00:00
github-actions[bot] 6e35972a97 Purge unhealthy [2026-10-29] 2026-10-29 07:13:58 +00:00
github-actions[bot] 50d43082bb Update reviews [2026-10-29] 2026-10-29 06:05:53 +00:00
github-actions[bot] aa41fbfeb1 chore(data): mark dead games 2026-10-29 04:34:32 +00:00
github-actions[bot] 37c88bd4e9 Ingest games [2026-10-29 01:08] 2026-10-29 01:08:54 +00:00
f2p-tracker-admin[bot] a0135dda30 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-29 01:00:30 +00:00
github-actions[bot] e3a82f384b Ingest games [2026-10-29 00:53] 2026-10-29 00:53:43 +00:00
f2p-tracker-admin[bot] ee2b502d67 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-29 00:45:29 +00:00
github-actions[bot] e9098b47eb Ingest games [2026-10-29 00:38] 2026-10-29 00:38:54 +00:00
f2p-tracker-admin[bot] 8b2da6cb86 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-29 00:30:29 +00:00
github-actions[bot] c33593d6a8 Auto update [2026-10-29] 2026-10-29 00:25:10 +00:00
github-actions[bot] c88059fb72 Ingest games [2026-10-29 00:23] 2026-10-29 00:23:56 +00:00
f2p-tracker-admin[bot] 6efcb75c11 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-29 00:15:30 +00:00
github-actions[bot] 0f7beba769 Ingest games [2026-10-29 00:08] 2026-10-29 00:08:44 +00:00
f2p-tracker-admin[bot] 56dfd1993d queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-29 00:00:26 +00:00
github-actions[bot] 0767a0b598 Snapshot [2026-10-28] 2026-10-28 23:11:11 +00:00
github-actions[bot] 13ad65d0b4 Refresh all-time peaks [2026-10-28] 2026-10-28 19:50:16 +00:00
github-actions[bot] f888dc2b20 Refresh anti-cheat [2026-10-28] 2026-10-28 17:30:00 +00:00
github-actions[bot] 39d2e4e957 Refresh store data [2026-10-28] 2026-10-28 17:23:48 +00:00
github-actions[bot] fc114896a8 Purge unhealthy [2026-10-28] 2026-10-28 07:08:47 +00:00
github-actions[bot] 4e08e13ba5 Update reviews [2026-10-28] 2026-10-28 06:06:02 +00:00
github-actions[bot] 545cb921e0 Top online [2026-10-28 03:41] 2026-10-28 03:41:36 +00:00
github-actions[bot] 6366fa34c3 Ingest games [2026-10-28 01:08] 2026-10-28 01:08:48 +00:00
f2p-tracker-admin[bot] 2f5ca07b5f queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-28 01:00:28 +00:00
github-actions[bot] 51cd5a1761 Ingest games [2026-10-28 00:53] 2026-10-28 00:54:00 +00:00
f2p-tracker-admin[bot] 774942b61f queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-28 00:45:36 +00:00
github-actions[bot] f586a2614b Ingest games [2026-10-28 00:38] 2026-10-28 00:38:50 +00:00
f2p-tracker-admin[bot] ef284ea30e queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-28 00:30:31 +00:00
github-actions[bot] e106fca107 Auto update [2026-10-28] 2026-10-28 00:25:07 +00:00
github-actions[bot] 3f7736f6a7 Ingest games [2026-10-28 00:23] 2026-10-28 00:23:56 +00:00
f2p-tracker-admin[bot] 69bb9fec77 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-28 00:15:30 +00:00
github-actions[bot] a9b783f5b2 Ingest games [2026-10-28 00:08] 2026-10-28 00:08:54 +00:00
f2p-tracker-admin[bot] 77638da47c queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-28 00:00:32 +00:00
github-actions[bot] 8d5708845b Snapshot [2026-10-27] 2026-10-27 23:10:19 +00:00
github-actions[bot] c8b9f53065 Refresh all-time peaks [2026-10-27] 2026-10-27 19:48:50 +00:00
github-actions[bot] 382b8cb25a Refresh store data [2026-10-27] 2026-10-27 17:26:13 +00:00
github-actions[bot] 33fe188bf1 Update reviews [2026-10-27] 2026-10-27 06:06:35 +00:00
github-actions[bot] 12fc995a74 Ingest games [2026-10-27 01:10] 2026-10-27 01:10:02 +00:00
f2p-tracker-admin[bot] 7b8831770a queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-27 01:01:31 +00:00
github-actions[bot] 64b93aff32 Ingest games [2026-10-27 00:53] 2026-10-27 00:53:58 +00:00
f2p-tracker-admin[bot] 7e731b4220 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-27 00:45:35 +00:00
github-actions[bot] 520aa3f59a Ingest games [2026-10-27 00:38] 2026-10-27 00:38:55 +00:00
f2p-tracker-admin[bot] 549fac6e86 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-27 00:30:30 +00:00
github-actions[bot] 17faea969d Auto update [2026-10-27] 2026-10-27 00:25:11 +00:00
github-actions[bot] 961c20c2cf Ingest games [2026-10-27 00:24] 2026-10-27 00:24:04 +00:00
f2p-tracker-admin[bot] 7d75afdcbc queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-27 00:15:34 +00:00
poli0981 c97d7900c3 Merge pull request #224 from poli0981/docs/waf-check-command
docs: rate-limit checks that work, and the Worker layer's measured per-server counting
2026-10-27 07:13:15 +07:00
poli0981andClaude Opus 5.5 0240abfd02 docs: the Worker's rate limits count per server, as measured
Measured on production after v4.5.1 deployed (2026-10-27, SIN): over one
keep-alive connection each budget held exactly - /api/no-such-route
121 x 404 then 429 with Retry-After, no-store and CORS; /api/human-check
19 then 429 - while requests on fresh connections, which Cloudflare
spreads over many servers, were never refused (175 human checks in 70 s
against a budget of 20). A probe Worker in a remote preview confirmed the
binding itself enforces (limit 5: 6 allowed, then refused).

So the layer stops browsers and connection-reusing scripts; a client that
reconnects for every request is the WAF rule's, which counted exactly
(250). The docs, CLAUDE.md, the module comment, wrangler.jsonc and the
unpublished v4.5.1 entry said "per location, approximate"; they now say
what was measured. The section 3b check used xargs (fresh connections) and
would have shown no 429 - it now sends everything over one connection.
No behaviour change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 07:10:29 +07:00
github-actions[bot] 7c620313b3 Ingest games [2026-10-27 00:08] 2026-10-27 00:08:55 +00:00
poli0981andClaude Opus 5.5 e167d7df02 docs(security): a WAF check command that actually trips the rule
The section 3a check ran 300 separate curls through xargs -P 30. Each one
pays a TLS handshake, so from here it managed about 21 requests a second -
300 x 200 in 14 s - and never crossed 250 in 10 s: the rule looked broken
when it was not. One `curl --parallel` with its URL list on stdin reuses
its connections and does: 250 x 200 then 150 x 429, measured against the
live site-wide rule on 2026-10-27.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 07:02:52 +07:00
f2p-tracker-admin[bot] 5f5ff0cc3a queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-27 00:00:29 +00:00
poli0981 16e65662b9 Merge pull request #223 from poli0981/feat/worker-rate-limits
v4.5.1 "Speed Bump": per-surface rate limits in the Worker
2026-10-27 07:00:27 +07:00
poli0981andClaude Opus 5.5 be805d74d5 release: v4.5.1 - The "Speed Bump" Edition (apps unchanged, 2.3.0)
Worker-side rate limits behind the edge rule, and the recommended
site-wide WAF rule. Repo-only: nothing in the apps changed, so desktop and
Android stay at 2.3.0 with no new build.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 06:57:31 +07:00
poli0981andClaude Opus 5.5 d8d395b568 feat(worker): per-surface rate limits behind the WAF rule
The zone's one Free-plan rate-limiting rule (IP, 10 s, block 10 s) stays
the first layer: it refuses a burst before the Worker is invoked and is the
only limit on the prerendered pages. The Worker now adds a second one with
the `ratelimits` bindings in wrangler.jsonc, 60-second windows and one
budget per surface, keyed by IPv4 address or IPv6 /64:

  RL_DATA   /api/data/*                             240/min
  RL_IMG    /img/*                                  600/min
  RL_API    /api/activity, /api/updates/desktop, …  120/min
  RL_HUMAN  /api/human-check                         20/min
  RL_ADMIN  /admin, /admin/*, /api/ingest/*         300/min

Checked after the country block and before every route and the Access
check; over a limit the answer is 429 + Retry-After: 60, no-store, with
CORS only where the route itself sends it (data, api). It fails open
(no binding, no CF-Connecting-IP, a throwing limit()) and logs no refusal.
Verified locally under wrangler dev: each budget refused exactly past its
limit, a second /64 address shared the first one's budget, pages were never
counted.

rate-limit.test.ts holds wrangler.jsonc to the code (binding names, period
60 = Retry-After, account-unique namespace ids) and checks that every
run_worker_first prefix draws on a budget. worker-configuration.d.ts gets
the five Env lines (and the IMG_MINT_PER_TICK value it had missed) without
regenerating the runtime types.

docs/SECURITY_SETUP.md section 3 describes both layers and recommends
widening the WAF rule to the whole zone except /_app/immutable/ at 250 per
10 s, counted from the build (a first visit sends 110-130 requests once
the service worker precaches); CLAUDE.md records the rules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 06:57:27 +07:00
github-actions[bot] e6b28b422e Snapshot [2026-10-26] 2026-10-26 23:13:54 +00:00
github-actions[bot] 01c62da2f8 Refresh all-time peaks [2026-10-26] 2026-10-26 19:52:22 +00:00
github-actions[bot] 2325f1d54e Refresh store data [2026-10-26] 2026-10-26 17:27:02 +00:00
poli0981 277e7f14c6 Merge pull request #219 from poli0981/release/v4.5.0
release: v4.5.0 "Groundwork" / apps 2.3.0
2026-10-26 15:00:12 +07:00
poli0981andClaude Opus 5.5 3bd5d90447 release: v4.5.0 "Groundwork" / apps 2.3.0
SvelteKit 3 (PR #218) under the site and the apps, plus Tauri 2.12.5 from
Dependabot #214. Desktop and Android 2.2.2 -> 2.3.0 (package.json + lock,
Cargo.toml + the f2p-tracker entry in Cargo.lock, tauri.conf.json);
CHANGELOG section dated, fresh [Unreleased].

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 14:58:03 +07:00
poli0981 1c501957cf Merge pull request #214 from poli0981/dependabot/cargo/web/src-tauri/cargo-minor-patch-4007e36411
build(deps): Bump the cargo-minor-patch group across 1 directory with 2 updates
2026-10-26 14:56:58 +07:00
dependabot[bot] fc23baf117 build(deps): Bump the cargo-minor-patch group across 1 directory with 2 updates
Bumps the cargo-minor-patch group with 2 updates in the /web/src-tauri directory: [tauri](https://github.com/tauri-apps/tauri) and [tauri-build](https://github.com/tauri-apps/tauri).


Updates `tauri` from 2.12.4 to 2.12.5
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-v2.12.4...tauri-v2.12.5)

Updates `tauri-build` from 2.7.3 to 2.7.4
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-build-v2.7.3...tauri-build-v2.7.4)

---
updated-dependencies:
- dependency-name: tauri
  dependency-version: 2.12.5
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
- dependency-name: tauri-build
  dependency-version: 2.7.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-26 07:47:12 +00:00
poli0981 e4edeb43e4 Merge pull request #218 from poli0981/feat/sveltekit-3
SvelteKit 3: migrate web/ to kit 3.1 and adapter-static 4
2026-10-26 14:45:53 +07:00
poli0981andClaude Opus 5.5 f42a854b66 fix(web): keep legacy hash links on this site (CodeQL js/xss)
The SvelteKit 3 fallback for a /#/ path that matches no route passed the
hash straight to location.replace(): CodeQL code-scanning alert #25,
client-side XSS, and an open redirect in practice - `#//other.example/x`
resolved to another site once goto rejected it.

The hash is now resolved against the page's origin and ignored when it
names another one, goto gets that URL, and an unmatched path goes to the
404 page at its fixed address (/error/404). Nothing from the hash reaches
location.* any more. Tests cover both off-site forms (`#//host`,
`#/\host`) and the 404 fallback; checked in a browser on `npm run dev`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 14:42:59 +07:00
poli0981andClaude Opus 5.5 0c454fad2c test(web): hold the SvelteKit 3 navigation, matcher and hook changes
- legacy-url: a /#/ path renders in place with { replace, reset: false },
  and one that matches no route falls back to location.replace (kit 3's
  goto rejects it).
- fallback-route: the re-render uses replace / reset: false / refreshAll
  (noScroll and keepFocus throw in kit 3's dev build), and leaves routes
  that hydrated or cannot fall back alone.
- params.legaldoc: every legal document matches; anything else does not.
- hooks.client: returns nothing for an ordinary error (kit 3 keeps its own
  message), and says it is reloading only when the stale-chunk reload ran.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 14:38:44 +07:00
poli0981andClaude Opus 5.5 0f600a99aa build(web): migrate to SvelteKit 3 and adapter-static 4
@sveltejs/kit 2.70.3 -> 3.1.0, @sveltejs/adapter-static 3.0.10 -> 4.0.0.
Closes GHSA-27mw-82g8-phjj and GHSA-pfhg-q3qv-9q6r (dismissed in v4.4.1
as not applicable), and drops the cookie override kit 2 needed: npm audit
reports nothing.

- Config: svelte.config.js is refused by kit 3. Its options are now
  sveltekitConfig(tauri) in build/sveltekit-config.ts, passed by
  vite.config.ts as sveltekit(sveltekitConfig(IS_TAURI)), with tests for
  both CSP flavours, paths.relative, the sitemap entry and the prerender
  404 handler. The unused, now-deprecated "@" alias and typescript.config
  hook are gone; tsconfig.json extends $app/tsconfig and owns `include`.
- $lib -> #lib (package.json imports), with .js on module imports.
  tsconfig repeats the mapping in `paths`: svelte-check --tsgo only maps
  .svelte imports through `paths`, and without it every #lib component
  fell back to the *.svelte shim (props unchecked; proven with a planted
  error).
- Param matchers: src/params/legaldoc.ts -> src/params.ts (defineParams).
  vite build imports that file with Node's own import(), so it imports
  #lib/legal.ts and legal.ts imports ./schema.ts by their real names.
- PWA: @vite-pwa/sveltekit never supported kit 3 and wrote the worker when
  the SERVER build closed, which kit 3's environment build does first.
  build/pwa.ts wires vite-plugin-pwa in a buildApp hook after kit's
  prerender and before its adapter, with the same globs and URL mapping.
- goto options renamed (replace, reset: false, refreshAll); the /games
  filter write is a shallow goto; a legacy /#/ path that matches no route
  falls back to location.replace (kit 3's goto rejects it). Hook types
  from @sveltejs/kit/hooks; the client handleError returns nothing to keep
  kit's message.
- runed 0.35 (bits-ui) peers kit ^2: overridden to our kit, as for
  echarts-wordcloud.

Verified against a kit 2 build of the same commit: same 11,037 files bar
hashed chunks, same non-immutable precache URLs, navigateFallback "/",
identical CSP per page (hashes masked), manifest and sitemap byte-equal,
same visible text.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 14:35:49 +07:00
poli0981 3a6aa447bd Merge pull request #213 from poli0981/chore/deps-security-2026-10-26
v4.4.1 "Tune-Up": dependency and security pass, apps 2.2.2
2026-10-26 13:53:55 +07:00
poli0981andClaude Opus 5.5 42b87a0da6 release: v4.4.1 "Tune-Up" / apps 2.2.2
Desktop and Android 2.2.1 -> 2.2.2 (package.json + lock, Cargo.toml + the
f2p-tracker entry in Cargo.lock, tauri.conf.json), so the apps ship the
patched rustls/webpki stack their updater uses. CHANGELOG section dated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 13:51:04 +07:00
poli0981andClaude Opus 5.5 d057e3f620 fix(deps): patch the open advisories in npm, cargo and pip; Node 24 actions
npm (web/):
- undici 7.30.1 through a "miniflare" override (GHSA-xjj6-f33q-929c,
  GHSA-4qv8-2p9j-2685, GHSA-f72v-6w45-q472). miniflare pins undici exactly
  and wrangler 4.152.0, the newest, still ships 7.29.1. Local tooling only.
- zod 4.6.7 (GHSA-mrhx-c7xc-m3w5, via knip).
- Minor/patch: @lucide/svelte 1.61.0, @tanstack/svelte-virtual 3.13.48,
  bits-ui 2.20.2, vite 8.3.5, wrangler 4.152.0, knip 6.43.0,
  @tauri-apps/cli 2.12.4.

cargo (web/src-tauri/Cargo.lock, targeted updates only):
- rustls 0.23.46 (RUSTSEC-2026-0346..0349), rustls-webpki 0.103.16
  (RUSTSEC-2026-0382), webpki-root-certs 1.0.11 (RUSTSEC-2026-0383),
  tokio 1.54.1 (RUSTSEC-2026-0386), anyhow 1.0.104 (RUSTSEC-2026-0190),
  event-listener 5.4.2 (RUSTSEC-2026-0221), plist 1.10.3 -> quick-xml
  0.42.0 (RUSTSEC-2026-0194/0195). Dependabot had none of these.
- Left upstream: zip 4 (tauri-plugin-updater 2.14.0 asks for ^4), glib 0.18
  (GTK 3), unmaintained proc-macro-error/zbus_names/zvariant.

pip: certifi 2026.10.23, coverage 7.17.0 (tests), with every file's hash.

CI: actions/checkout v4/v5 -> v6 and actions/setup-python v5 -> v6
everywhere (the Node 20 majors warned on every data job), rust-cache 2.9.3
by SHA. dependabot.yml says why those majors are taken by hand.

CLAUDE.md: the undici override and when to drop it; why SvelteKit stays on 2
(GHSA-27mw-82g8-phjj and GHSA-pfhg-q3qv-9q6r need setHeaders or use:enhance,
which the app does not have).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 13:50:58 +07:00
github-actions[bot] 9477b6a022 Update reviews [2026-10-26] 2026-10-26 06:06:54 +00:00
github-actions[bot] 185511162d chore(data): mark dead games 2026-10-26 04:45:17 +00:00
github-actions[bot] fd716b0ef9 Ingest games [2026-10-26 01:27] 2026-10-26 01:27:23 +00:00
f2p-tracker-admin[bot] b30ebd3f77 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-26 01:18:58 +00:00
github-actions[bot] 98f3d2ed0f Ingest games [2026-10-26 01:05] 2026-10-26 01:05:19 +00:00
f2p-tracker-admin[bot] c46952dda6 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-26 00:56:47 +00:00
github-actions[bot] 494678aee0 Ingest games [2026-10-26 00:38] 2026-10-26 00:38:58 +00:00
f2p-tracker-admin[bot] bb392aad8d queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-26 00:30:33 +00:00
github-actions[bot] 0cacacf97d Auto update [2026-10-26] 2026-10-26 00:25:01 +00:00
github-actions[bot] c2e5522cb3 Ingest games [2026-10-26 00:23] 2026-10-26 00:23:55 +00:00
f2p-tracker-admin[bot] a8e0dd986b queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-26 00:15:31 +00:00
github-actions[bot] dca1a84940 Ingest games [2026-10-26 00:11] 2026-10-26 00:11:26 +00:00
f2p-tracker-admin[bot] 21b9f85832 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-26 00:03:02 +00:00
github-actions[bot] 73c7552b0c Snapshot [2026-10-25] 2026-10-25 23:13:48 +00:00
github-actions[bot] 44793d1565 Refresh all-time peaks [2026-10-25] 2026-10-25 19:46:40 +00:00
github-actions[bot] 503a2c7ff6 Refresh anti-cheat [2026-10-25] 2026-10-25 17:21:07 +00:00
github-actions[bot] 7bcb6ed037 Refresh store data [2026-10-25] 2026-10-25 17:16:35 +00:00
github-actions[bot] 2953afcebe Ingest games [2026-10-25 08:07] 2026-10-25 08:07:57 +00:00
f2p-tracker-admin[bot] 97becf5c91 queue: 87 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-25 08:00:35 +00:00
github-actions[bot] 0aec1a26fa Update reviews [2026-10-25] 2026-10-25 06:05:42 +00:00
github-actions[bot] 5dae3d2c3c Ingest games [2026-10-25 05:16] 2026-10-25 05:16:24 +00:00
f2p-tracker-admin[bot] 3ffc4b63a9 queue: 6 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-25 05:15:36 +00:00
github-actions[bot] bf2a2e35a2 Ingest games [2026-10-25 05:01] 2026-10-25 05:01:22 +00:00
f2p-tracker-admin[bot] d3ac2728aa queue: 7 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-25 05:00:31 +00:00
github-actions[bot] 4f9db76cf6 Ingest games [2026-10-25 04:53] 2026-10-25 04:53:50 +00:00
f2p-tracker-admin[bot] d047895139 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-25 04:45:29 +00:00
github-actions[bot] d9a1d1bbb3 Ingest games [2026-10-25 04:38] 2026-10-25 04:38:48 +00:00
f2p-tracker-admin[bot] 6958ebc2f2 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-25 04:30:32 +00:00
github-actions[bot] 10cf2a75b6 Ingest games [2026-10-25 04:24] 2026-10-25 04:24:17 +00:00
f2p-tracker-admin[bot] 55166608d5 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-25 04:15:55 +00:00
github-actions[bot] c8f96808d0 Ingest games [2026-10-25 04:08] 2026-10-25 04:08:54 +00:00
f2p-tracker-admin[bot] f38d38c734 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-25 04:00:27 +00:00
github-actions[bot] 6e9259f256 Top online [2026-10-25 03:40] 2026-10-25 03:40:18 +00:00
poli0981 5d444e8655 Merge pull request #207 from poli0981/dependabot/npm_and_yarn/web/npm-minor-patch-4c27fb7863
build(deps): Bump the npm-minor-patch group across 1 directory with 3 updates
2026-10-25 07:46:50 +07:00
poli0981 d2b38730a2 Merge branch 'main' into dependabot/npm_and_yarn/web/npm-minor-patch-4c27fb7863 2026-10-25 07:41:44 +07:00
poli0981 b5ea590c55 Merge pull request #212 from poli0981/dependabot/npm_and_yarn/web/npm-security-b244b93465
build(deps): Bump the npm-security group across 1 directory with 2 updates
2026-10-25 07:38:54 +07:00
poli0981 3ac096ff3a Merge branch 'main' into dependabot/npm_and_yarn/web/npm-minor-patch-4c27fb7863 2026-10-25 07:34:43 +07:00
poli0981 836c8e692d Merge branch 'main' into dependabot/npm_and_yarn/web/npm-security-b244b93465 2026-10-25 07:34:34 +07:00
github-actions[bot] 130e234461 Auto update [2026-10-25] 2026-10-25 00:22:38 +00:00
poli0981 d717389be9 Merge branch 'main' into dependabot/npm_and_yarn/web/npm-security-b244b93465 2026-10-25 07:14:16 +07:00
poli0981 9d88249e98 Merge branch 'main' into dependabot/npm_and_yarn/web/npm-minor-patch-4c27fb7863 2026-10-25 07:14:02 +07:00
github-actions[bot] ff48344492 Snapshot [2026-10-24] 2026-10-24 23:12:41 +00:00
github-actions[bot] 5271aebf13 Refresh all-time peaks [2026-10-24] 2026-10-24 19:48:26 +00:00
github-actions[bot] 9331fc6c62 Refresh anti-cheat [2026-10-24] 2026-10-24 17:18:35 +00:00
github-actions[bot] ca06f83c76 Refresh store data [2026-10-24] 2026-10-24 17:14:04 +00:00
github-actions[bot] 15fdcbd421 Update reviews [2026-10-24] 2026-10-24 06:05:45 +00:00
github-actions[bot] 04b52cf9e3 Ingest games [2026-10-24 05:17] 2026-10-24 05:17:06 +00:00
f2p-tracker-admin[bot] e0c4a281f0 queue: 16 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-24 05:15:26 +00:00
dependabot[bot] 2dd57e2e29 build(deps): Bump the npm-security group across 1 directory with 2 updates
Bumps the npm-security group with 2 updates in the /web directory: [fast-uri](https://github.com/fastify/fast-uri) and [serialize-javascript](https://github.com/yahoo/serialize-javascript).


Updates `fast-uri` from 3.1.8 to 3.1.9
- [Release notes](https://github.com/fastify/fast-uri/releases)
- [Commits](https://github.com/fastify/fast-uri/compare/v3.1.8...v3.1.9)

Updates `serialize-javascript` from 7.1.2 to 7.1.4
- [Release notes](https://github.com/yahoo/serialize-javascript/releases)
- [Commits](https://github.com/yahoo/serialize-javascript/compare/v7.1.2...v7.1.4)

---
updated-dependencies:
- dependency-name: fast-uri
  dependency-version: 3.1.9
  dependency-type: indirect
  dependency-group: npm-security
- dependency-name: serialize-javascript
  dependency-version: 7.1.4
  dependency-type: indirect
  dependency-group: npm-security
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-24 02:58:20 +00:00
poli0981 3393d2e937 Merge pull request #202 from poli0981/dependabot/cargo/web/src-tauri/cargo-minor-patch-cec310f51b
build(deps): Bump tauri from 2.12.2 to 2.12.4 in /web/src-tauri in the cargo-minor-patch group
2026-10-24 07:41:56 +07:00
poli0981 a66c01eb26 Merge branch 'main' into dependabot/npm_and_yarn/web/npm-minor-patch-4c27fb7863 2026-10-24 07:38:32 +07:00
poli0981 57c0281f11 Merge branch 'main' into dependabot/cargo/web/src-tauri/cargo-minor-patch-cec310f51b 2026-10-24 07:37:57 +07:00
github-actions[bot] 2b08ee79ce Auto update [2026-10-24] 2026-10-24 00:20:30 +00:00
github-actions[bot] 1237debccc Snapshot [2026-10-23] 2026-10-23 23:14:14 +00:00
github-actions[bot] 56e2010866 Refresh all-time peaks [2026-10-23] 2026-10-23 19:49:28 +00:00
github-actions[bot] f7eced68a1 Refresh store data [2026-10-23] 2026-10-23 17:18:44 +00:00
github-actions[bot] 9aa849681e Update reviews [2026-10-23] 2026-10-23 15:50:23 +00:00
poli0981 8c81afab57 Merge pull request #210 from poli0981/fix/reviews-without-appreviews
fix(reviews): stop depending on appreviews, which now redirects
2026-10-23 22:47:55 +07:00
poli0981andClaude Opus 5.5 11fb7a5b43 fix(reviews): stop depending on appreviews, which now redirects
The first run of the new Update Reviews on main asked appreviews about the
12 games GetItems counted at 0, and all 12 failed: since 2026-10-23
store.steampowered.com/appreviews/<id>?json=1 answers 302 to the store
front, from GitHub's runners as from anywhere else (it worked on 10-17).
The 38 games the ingest added that day were listed with "N/A".

- fetch_full() falls back to the GetItems summary when appreviews gives
  none (reviews_from_store_api()), so an ingest gets the value the daily
  refresh would write.
- update_reviews: a game never read ("N/A", nothing) with a count of 0
  becomes "No reviews" without a question; the first count GetItems has
  replaces it. A stored percentage is still never replaced by a 0 without a
  second source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:44:57 +07:00
github-actions[bot] 3c64923e1f Update reviews [2026-10-23] 2026-10-23 15:37:33 +00:00
github-actions[bot] f2b395e31e Purge unhealthy [2026-10-23] 2026-10-23 15:35:02 +00:00
github-actions[bot] b07ba5c0a3 Snapshot [2026-10-23] 2026-10-23 15:32:28 +00:00
github-actions[bot] efee5737ac Snapshot [2026-10-23] 2026-10-23 15:32:01 +00:00
poli0981 5eadfbf34e Merge pull request #209 from poli0981/feat/pipeline-headroom
v4.4.0 — The Headroom Edition: data jobs that scale with the catalogue
2026-10-23 22:28:58 +07:00
poli0981andClaude Opus 5.5 c9db1fb181 fix(store): do not claim what the store API says in the not-free warning
The store refresh never asks it; the warning now says what is known.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:24:37 +07:00
poli0981andClaude Opus 5.5 f59496d2c4 docs(changelog): say what else v4.4.0 carries
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:23:43 +07:00
poli0981andClaude Opus 5.5 cd4e78a87c release: v4.4.0 - The "Headroom" Edition (apps unchanged, 2.2.1)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:22:25 +07:00
poli0981andClaude Opus 5.5 0897443bd6 docs: the pipeline-scale assessment, CLAUDE.md, README, CHANGELOG
docs/plan/18-pipeline-scale.md holds the measurements (9,847 games,
+~280 a day), what each job cost, what GetItems answers, the direction
and what is left. CLAUDE.md gains the rules for reviews, the purge,
budgets and the data-write group; README the new schedules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:22:09 +07:00
poli0981andClaude Opus 5.5 529b8603c3 ci(pipeline): queue data-write runs and start each on the latest main
- queue: max on every data-write workflow (GitHub, 2026-05-07): up to
  100 runs wait, first in, first out. The default kept one, and a run
  queueing behind a running job cancelled it.
- ref: main on every checkout. A run's commit is fixed when it is
  created, so a run that waited behind another data job wrote shards
  from before that job's commit; Auto Update JSON failed four days in
  ten on the rebase conflict in data/index.json.
- timeout-minutes everywhere, and JOB_BUDGET_MINUTES at least 20 below
  it for the long loops (never for the ingest, which empties its queue).
- pipeline.test.ts fails on a data-write workflow missing any of these.
- The admin's Pipeline and Automation pages, docs/ADMIN.md and the
  auto-approve comment no longer say a push evicts a waiting job; the
  idle gate stays, so a batch's ingest starts at once.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:22:08 +07:00
poli0981andClaude Opus 5.5 6e7d1bcf15 chore(pipeline): retire Check Dead Links
It sent a HEAD request to every store page every five days, 5.5 hours at
9,847 games, and flagged 404/410. Steam sends a delisted app's page to
the store front, which answers 200: scripts/dead_links.log never existed
and no game ever became "delisted". The purge's GetItems screen sees
delisted games (unlisted) instead.

Removes the workflow, bash/dead_links.sh, scripts/check_dead_links.py
and DEAD_LINKS_LOG, and the workflow from web/shared/pipeline.ts and the
failure notifier's list. check_store_page() stays: it is the health
check's last resort.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:22:08 +07:00
poli0981andClaude Opus 5.5 1da4d5940e feat(pipeline): keep the store, peaks and re-fetch runs bounded
- Refresh Store Data: the page and appdetails cycles grow past 2,000
  pages / 500 appdetails a day (7 -> 14, 30 -> 60) instead of the run,
  the slice comes in a daily order, and the store step has a budget. A
  game appdetails no longer calls free is listed in a ::warning::, the
  case the purge's two-signal rule cannot see; nothing is written.
- Refresh All-Time Peaks: 30 -> 60 days past 400 pages a day, never
  shorter, so SteamCharts is still asked at most once a month a game;
  the budget stops it with a warning like a refusal does.
- Force Re-fetch: --part K/N, oldest last_updated first, each game
  cleared on a copy that replaces it only once appdetails has answered;
  no final loop stamping every game. Parts queue one after another.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:22:08 +07:00
poli0981andClaude Opus 5.5 74e1845fc4 feat(purge): remove a game only when two of Steam's answers agree
The purge asked appdetails about every game, 5.3 hours at 9,847, and one
answer was enough to remove one - appdetails has answered success:false
for live games in bursts (2026-09-27).

GetItems now screens the whole catalogue in a few minutes (unknown,
hidden, unlisted, coming soon, not is_free; never type), and
check_game_health() must confirm each flag; "unavailable" is asked again
five minutes later. A failed batch or a network error never reads as
gone, blocklisted games are not asked about, and more than 500 flags or
100 removals stops the run before anything is written. Removals are
logged as before. A notice names earlier removals Steam has since undone.

The dry run on the real catalogue: 8 flagged, 3 removed (the three
unlisted games), 5 kept because appdetails calls them free. Daily now.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:21:59 +07:00
poli0981andClaude Opus 5.5 49f0c56ed7 feat(pipeline): read reviews for every game from Steam's store API
Update Reviews asked appreviews about one game at a time, two seconds a
game. At 9,847 games it ran into GitHub's six-hour limit on 2026-10-23
and was stopped with nothing saved; five of its ten runs before that
were cancelled while waiting.

- SteamClient.fetch_items(): GetItems for a whole catalogue, a failed
  batch costing only its own ids (the anti-cheat sweep now uses it).
- update_reviews.py reads review_summary() for every game, ~2 minutes,
  daily. Steam floors its percentage; reviews_from_summary() floors
  appreviews in integers too, so an ingest and the refresh agree. A
  count of 0 is never written on GetItems' word (it said 0 for a game
  with thousands): a stored percentage or "N/A" is asked on appreviews,
  at most 300 a run. last_updated moves on a change, and on a 14-20 day
  heartbeat that keeps the site's 30-day "stale" badge quiet without
  rewriting every record every run.
- core/budget.py: JOB_BUDGET_MINUTES. Past it process_batch() starts no
  further game, so a job saves what it did instead of being killed;
  a ::warning:: when a loop used three quarters of its budget.
- rotation.cycle_for() / daily_order(): cycles that grow with the
  catalogue as multiples of their base, and an order that changes daily.
- The player-count loops skip the batch pauses meant for store pages
  (Top Online ~27 min instead of 48) and take a deadline, like
  update_all_full().

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 22:21:59 +07:00
github-actions[bot] 01a631bb22 Ingest games [2026-10-23 05:17] 2026-10-23 05:17:04 +00:00
f2p-tracker-admin[bot] 43af58d097 queue: 16 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-23 05:15:26 +00:00
github-actions[bot] 383cbada09 Top online [2026-10-23 04:01] 2026-10-23 04:01:41 +00:00
github-actions[bot] 34c1c1746f Ingest games [2026-10-23 02:32] 2026-10-23 02:32:37 +00:00
f2p-tracker-admin[bot] 3056ffc366 queue: 22 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-23 02:30:26 +00:00
github-actions[bot] e2c2d730ca Auto update [2026-10-23] 2026-10-23 00:21:37 +00:00
github-actions[bot] f50321245a Snapshot [2026-10-22] 2026-10-22 23:14:58 +00:00
github-actions[bot] f471140e55 Refresh all-time peaks [2026-10-22] 2026-10-22 19:48:48 +00:00
github-actions[bot] b4f7e31d01 Refresh store data [2026-10-22] 2026-10-22 17:19:15 +00:00
poli0981 e4039aec5f Merge pull request #208 from poli0981/test/sonar-new-code-coverage
test: cover the new code SonarCloud's gate counts as untested
2026-10-22 19:55:37 +07:00
poli0981andClaude Opus 5.5 92667b27ac test: cover the new code SonarCloud's gate counts as untested
main's first analysis with coverage failed the "Sonar way" gate at 75.0%
on new code (lines 92/114, conditions 16/30). These tests cover what was
untested in that new code:

- utils.ts: formatNumber, parseIntSafe and parseReleaseDate had no tests.
  The year-only branch of parseReleaseDate is unreachable (Date.parse
  already reads "2025" as ISO), so only its other side is covered.
- reconcile.ts: an approval the pipeline rejected afterwards becoming
  failed (by appid and by link, with no decision recorded), and one removed
  only before it, or with no timestamp, staying approved past a
  malformed line.
- delete_game.py --list, empty and not; discover_new's search parser on a
  page cut off inside an anchor tag.

Against main's new lines and conditions, these lift the estimate to
121/144, about 84%.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 19:52:48 +07:00
dependabot[bot] 70ec88fbb3 build(deps): Bump the npm-minor-patch group across 1 directory with 3 updates
Bumps the npm-minor-patch group with 3 updates in the /web directory: [@lucide/svelte](https://github.com/lucide-icons/lucide/tree/HEAD/packages/svelte), [knip](https://github.com/webpro-nl/knip/tree/HEAD/packages/knip) and [wrangler](https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler).


Updates `@lucide/svelte` from 1.58.0 to 1.59.0
- [Release notes](https://github.com/lucide-icons/lucide/releases)
- [Commits](https://github.com/lucide-icons/lucide/commits/1.59.0/packages/svelte)

Updates `knip` from 6.41.0 to 6.42.0
- [Release notes](https://github.com/webpro-nl/knip/releases)
- [Commits](https://github.com/webpro-nl/knip/commits/knip@6.42.0/packages/knip)

Updates `wrangler` from 4.151.1 to 4.151.2
- [Release notes](https://github.com/cloudflare/workers-sdk/releases)
- [Commits](https://github.com/cloudflare/workers-sdk/commits/wrangler@4.151.2/packages/wrangler)

---
updated-dependencies:
- dependency-name: "@lucide/svelte"
  dependency-version: 1.59.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: knip
  dependency-version: 6.42.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: wrangler
  dependency-version: 4.151.2
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-22 12:48:03 +00:00
poli0981 c50aea93d6 Merge pull request #206 from poli0981/ci/sonar-coverage-import
ci(sonar): import test coverage instead of excluding it
2026-10-22 19:44:45 +07:00
poli0981andClaude Opus 5.5 df91b42c4f ci(sonar): import test coverage instead of excluding it
The scan job now runs both suites with coverage before scanning:
pytest --cov (pyproject.toml: scripts/ without its tests, relative
paths, coverage.xml) and `npm run test:coverage` (vite.config.ts: v8,
lcov with projectRoot "..", so paths start web/). sonar-project.properties
names both reports and drops sonar.coverage.exclusions.

requirements-test.txt gains pytest-cov 7.1.0 and coverage 7.16.2 with
every file's hash (uv pip compile --universal --generate-hashes
--python-version 3.15; the existing pins are unchanged). web gains
@vitest/coverage-v8 5.0.5, matching vitest; none of its packages has an
install script. Coverage stays off for a plain `npm test`.

The token check is its own job, so the scan steps no longer each repeat
the condition; the workflow grants nothing at the top and the scan job
contents: read. `npm run build:admin` replaces the bare `svelte-kit
sync`: it syncs too, and writes the admin bundle the Worker's tests load.

Locally: 576 vitest tests at 58.35% of lines, 299 pytest tests at 57.7%.
Against main's new-code lines (SonarCloud's isNew), the reports cover
92 of 114 coverable lines, 80.7%: the 80% gate is borderline.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 19:34:51 +07:00
poli0981 8efc28e3bb Merge pull request #205 from poli0981/ci/sonar-coverage-unmeasured
ci(sonar): declare coverage unmeasured so the quality gate does not read 0%
2026-10-22 19:25:31 +07:00
poli0981andClaude Opus 5.5 bbe4e3e118 ci(sonar): declare coverage unmeasured so the gate does not read 0%
The first full CI analysis of main (db804e27) failed the "Sonar way"
quality gate on one condition: coverage on new code 0.0% < 80%, over 109
new lines. The scan uploads no test report, so every executable line
counted as uncovered; automatic analysis never computed coverage, so the
condition was never evaluated before. Every other condition passed, with
0 open issues and 0 hotspots.

sonar.coverage.exclusions=**/* restores that: no lines to cover, no
coverage condition. Measuring coverage means generating reports in the
workflow and removing this line in the same change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 19:22:50 +07:00
poli0981 db804e271e Merge pull request #204 from poli0981/ci/sonarcloud-ci-analysis
ci: analyse with SonarCloud in CI instead of automatic analysis
2026-10-22 19:19:06 +07:00
poli0981andClaude Opus 5.5 98430b7bb6 ci(sonar): give the TypeScript analyser the project's tsconfigs
The first CI scan logged "Failed to parse tsconfig web/tsconfig.json":
it extends .svelte-kit/tsconfig.json, which only `svelte-kit sync`
writes, so web/src was analysed without its compiler options or types.
The job now installs web/ (npm ci --ignore-scripts) and syncs before
scanning; both outputs are gitignored, so neither is analysed itself.

sonar.typescript.tsconfigPaths names all six tsconfigs: auto-detection
found only the two named tsconfig.json, leaving the Worker, shared/ and
the tests on fallback options.

The toolchain plan no longer claims sonar-python knows 3.15: the scan
warns and analyses as 3.14.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 19:16:51 +07:00
poli0981andClaude Opus 5.5 b465540faf ci: analyse with SonarCloud in CI instead of automatic analysis
A sonarcloud.yml workflow runs SonarSource/sonarqube-scan-action (pinned to
the v8.3.0 commit) on pull requests and main, with full history for blame.
Commits that touch only what the data jobs write are skipped, and a run
without SONAR_TOKEN (forks, Dependabot) passes without scanning.

.sonarcloud.properties becomes sonar-project.properties, now naming the
organization and project key; its scope settings are unchanged. The
toolchain test, Web CI's paths, CLAUDE.md and docs follow the rename.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 19:12:56 +07:00
github-actions[bot] c0bd0d1c57 Ingest games [2026-10-22 05:16] 2026-10-22 05:16:54 +00:00
f2p-tracker-admin[bot] e8c724f2e9 queue: 14 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-22 05:15:28 +00:00
github-actions[bot] feb356edbf chore(data): mark dead games 2026-10-22 04:40:18 +00:00
dependabot[bot] 78a6cc04a5 build(deps): Bump tauri in /web/src-tauri in the cargo-minor-patch group
Bumps the cargo-minor-patch group in /web/src-tauri with 1 update: [tauri](https://github.com/tauri-apps/tauri).


Updates `tauri` from 2.12.2 to 2.12.4
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-v2.12.2...tauri-v2.12.4)

---
updated-dependencies:
- dependency-name: tauri
  dependency-version: 2.12.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-22 03:28:35 +00:00
poli0981 9f2aeb8721 Merge pull request #201 from poli0981/chore/toolchain-ts7-node26-py315
Toolchain: Node 26, Python 3.15, TypeScript 7 (beside 6); certifi 2026.10.19
2026-10-22 10:27:30 +07:00
poli0981andClaude Opus 5.5 e01fc78331 fix(test): compare toolchain pins as strings, not built patterns
CodeQL (js/incomplete-sanitization, high, alert #24) flagged the helper
that turned a version into a RegExp by escaping only its dots. The versions
come from the repository's own files, but no pattern needs building at all:
a pin is now unquoted and compared as a string, and the @types/node major is
read with a literal pattern. The test still fails on a drifted Python, an
unquoted version and a lone .node-version change, each with the file named.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 10:27:03 +07:00
poli0981andClaude Opus 5.5 ee146dd023 docs: the TypeScript 7 / Node 26 / Python 3.15 move, and a runbook for 7.1
- docs/plan/16-toolchain-2026.md: the assessment - what each release
  changes, what was measured here, the decisions, how to move each runtime
  next time, and what was left.
- docs/plan/17-typescript-7.1.md: the springboard for dropping TypeScript 6
  once 7.1 ships - start conditions and how to check them, the steps, the
  planted-error table and the baselines to compare against.
- CLAUDE.md: "TypeScript is two packages, on purpose" and "One version of
  each runtime"; the uv compile line says 3.15.
- dev_env (EN/VI), README, AUTHORS, TAURI.md, web/README, THIRD_PARTY,
  DEPLOYMENT (Workers Builds' NODE_VERSION=26, the Checks paragraph),
  ACKNOWLEDGEMENTs and the About page's stack list ("TypeScript 7 + 6").
- CHANGELOG: the Tooling entry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 10:19:52 +07:00
poli0981andClaude Opus 5.5 86f68c247b fix(deps): certifi 2026.10.19 (GHSA-6q48-6c7w-9gw2)
eMudhra's `emSign ECC Root CA - G3` had intermediates whose private keys
were compromised. certifi 2026.10.18, the version pinned here, had already
removed every emSign root; 2026.10.19 restores the three that are not
affected (G1, C1, ECC C3) and keeps G3 out. The advisory's range still
covered 2026.10.18, so pip-audit flagged it. The hashes come from
`uv pip compile`, one per file on PyPI (wheel and sdist); every other pin
is unchanged.

Checked on Python 3.15.1: --require-hashes --only-binary :all: installs,
the 299 tests pass, pip-audit finds no known vulnerability.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 10:19:46 +07:00
poli0981andClaude Opus 5.5 ca7f8e3e0c test(web): hold the Node, Python and TypeScript pins together
web/shared/toolchain.test.ts fails when a pin drifts:
- web/.node-version is one major, which every setup-node step,
  engines.node and the @types/node major repeat;
- every setup-python step installs sonar.python.version, which the
  --python-version in requirements.txt's header repeats; codeql.yml is the
  one named exception (3.14);
- each workflow has as many version keys as setup steps, and every version
  is a quoted literal (unquoted, YAML reads 3.10 as 3.1);
- `typescript` is 6, @typescript/native is npm:typescript@~7, and no script
  calls a bare tsc.

Web CI also runs on .github/workflows/** and .sonarcloud.properties, so a
pull request that moves only a pin meets the test - and pipeline.test.ts,
which reads the workflows for the data-write group, no longer misses a
workflow-only change either.

Proven by breaking one pin at a time (one workflow's Python, .node-version
alone, a setup-node switched to node-version-file): each failed the test
with the file named.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 10:19:45 +07:00
poli0981andClaude Opus 5.5 f3585fe8e6 build(web): Node 26, and TypeScript 7 beside TypeScript 6
Node:
- web/.node-version (26) is the pin. The five setup-node steps say '26' as
  a literal, not node-version-file: release-android.yml checks out the tag
  it rebuilds, and older tags have no such file.
- engines.node >=26 (advisory) and @types/node ^26.6.5; TypeScript 6 still
  type-checks clean with the new types.

TypeScript:
- TypeScript 7.0 has no JavaScript API, and svelte-check (which refuses
  `typescript` 7) and `svelte-kit sync` (route $types) need one, so
  `typescript` stays ^6.0.3 and 7 is the alias
  "@typescript/native": "npm:typescript@~7.0.2", the layout svelte-check
  documents. ~7.0 because 7.1 breaks svelte-check's experimental mode.
- `check` runs svelte-check --tsgo, on TypeScript 7. `check:admin` stays on
  6: --tsgo maps a tsconfig outside the workspace root onto the app's
  components (seen: false errors in src/routes instead of the admin's).
- The four `tsc -p` steps and typecheck:worker call
  node node_modules/@typescript/native/bin/tsc: both packages declare a
  `tsc` bin, so node_modules/.bin/tsc could be either.
- "DOM.Iterable" leaves the admin tsconfigs (an empty lib since 6.0).
- Dependabot ignores the alias (it mishandles npm: aliases) and keeps
  ignoring `typescript` majors, now with the reason.

Checked: type errors planted in a route's script, as a wrong prop on
src/lib/ui/Badge.svelte, in a +page.ts and in one file per tsc config were
each reported by TypeScript 7 (the admin's by 6), every step exiting 1;
--listFilesOnly gives the same programs on 6 and 7; the four tsc checks take
0.5 s instead of 6.0 s. From a clean `npm ci --ignore-scripts` on Node
26.12.1: typecheck, the tests, build, verify-dist (web and tauri), cf:check
and knip (report unchanged) pass, with still exactly three packages that
have install scripts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 10:19:38 +07:00
poli0981andClaude Opus 5.5 09991874d7 ci(python): run the pipeline, its tests and every data job on Python 3.15
- Sixteen setup-python steps move from '3.12' to '3.15'. codeql.yml alone
  stays on '3.14': CodeQL's supported-languages page lists Python up to 3.14
  and its extractor runs on that interpreter; the pipeline uses no 3.15-only
  syntax.
- The updater-json job of release-desktop.yml sets up 3.15 instead of
  running the runner image's python3.
- Four text-mode writes name encoding="utf-8": the dead-link log, both
  leaderboards and clear_temp(). 3.15 makes UTF-8 the default (PEP 686); on
  Windows an older Python writes cp1252, which cannot encode the
  leaderboards' emoji, so those scripts crashed there. CI already wrote
  UTF-8, so no committed output changes.
- requirements.txt's compile line and sonar.python.version say 3.15.
  `uv pip compile --universal` gives the same lock for 3.12 and 3.15, and
  every pin installs on 3.15 with --require-hashes --only-binary :all:
  (charset-normalizer's cp315 wheels were already hashed).

Checked on Python 3.15.1: the 299 tests pass with EncodingWarning and
DeprecationWarning as errors; edit_game.py --check and delete_game.py
--check pass; a full save_main(load_main()) on a copy of the data leaves all
36 files byte-identical to HEAD, as on 3.14, so no shard and no index.json
changes when the data jobs move.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 10:19:30 +07:00
github-actions[bot] e10d2e7b9d Auto update [2026-10-22] 2026-10-22 00:19:50 +00:00
github-actions[bot] 5ebf518fd3 Snapshot [2026-10-21] 2026-10-21 23:14:08 +00:00
github-actions[bot] 6ef0631ded Refresh all-time peaks [2026-10-21] 2026-10-21 19:46:49 +00:00
github-actions[bot] 3f0000a176 Refresh store data [2026-10-21] 2026-10-21 17:11:06 +00:00
github-actions[bot] a66bdb67cd Ingest games [2026-10-21 09:46] 2026-10-21 09:46:41 +00:00
f2p-tracker-admin[bot] 5fd1bcb8b7 queue: 12 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-21 09:45:30 +00:00
github-actions[bot] 529df08b7d Top online [2026-10-21 04:03] 2026-10-21 04:03:01 +00:00
github-actions[bot] bfc81c36da Auto update [2026-10-21] 2026-10-21 00:20:11 +00:00
github-actions[bot] 71109542d8 Snapshot [2026-10-20] 2026-10-20 23:13:52 +00:00
github-actions[bot] 7203111f6d Refresh all-time peaks [2026-10-20] 2026-10-20 19:48:04 +00:00
github-actions[bot] 278fee3f69 Refresh store data [2026-10-20] 2026-10-20 17:20:52 +00:00
github-actions[bot] 87d8e301f9 Ingest games [2026-10-20 16:21] 2026-10-20 16:21:09 +00:00
f2p-tracker-admin[bot] efbd54c387 queue: 69 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-20 16:15:29 +00:00
github-actions[bot] 458c0e6f18 Ingest games [2026-10-20 16:08] 2026-10-20 16:08:55 +00:00
f2p-tracker-admin[bot] e43332b063 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-20 16:00:45 +00:00
github-actions[bot] 6ea6e4e31b Ingest games [2026-10-20 15:53] 2026-10-20 15:53:46 +00:00
f2p-tracker-admin[bot] 58eff344d4 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-20 15:45:31 +00:00
github-actions[bot] f4b1d9bcf1 Ingest games [2026-10-20 15:38] 2026-10-20 15:38:53 +00:00
f2p-tracker-admin[bot] 9477e3c8d3 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-20 15:30:39 +00:00
dependabot[bot]andpoli0981 46949e386d build(deps): Bump the npm-minor-patch group in /web with 4 updates (#200)
Bumps the npm-minor-patch group in /web with 4 updates: [@lucide/svelte](https://github.com/lucide-icons/lucide/tree/HEAD/packages/svelte), [@tanstack/svelte-virtual](https://github.com/TanStack/virtual/tree/HEAD/packages/svelte-virtual), [svelte-check](https://github.com/sveltejs/language-tools) and [wrangler](https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler).


Updates `@lucide/svelte` from 1.57.0 to 1.58.0
- [Release notes](https://github.com/lucide-icons/lucide/releases)
- [Commits](https://github.com/lucide-icons/lucide/commits/1.58.0/packages/svelte)

Updates `@tanstack/svelte-virtual` from 3.13.46 to 3.13.47
- [Release notes](https://github.com/TanStack/virtual/releases)
- [Changelog](https://github.com/TanStack/virtual/blob/main/packages/svelte-virtual/CHANGELOG.md)
- [Commits](https://github.com/TanStack/virtual/commits/@tanstack/svelte-virtual@3.13.47/packages/svelte-virtual)

Updates `svelte-check` from 4.7.6 to 4.7.7
- [Release notes](https://github.com/sveltejs/language-tools/releases)
- [Commits](https://github.com/sveltejs/language-tools/compare/svelte-check@4.7.6...svelte-check@4.7.7)

Updates `wrangler` from 4.151.0 to 4.151.1
- [Release notes](https://github.com/cloudflare/workers-sdk/releases)
- [Commits](https://github.com/cloudflare/workers-sdk/commits/wrangler@4.151.1/packages/wrangler)

---
updated-dependencies:
- dependency-name: "@lucide/svelte"
  dependency-version: 1.58.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: "@tanstack/svelte-virtual"
  dependency-version: 3.13.47
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: svelte-check
  dependency-version: 4.7.7
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: wrangler
  dependency-version: 4.151.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-10-20 21:54:58 +07:00
dependabot[bot]andpoli0981 f82388be0b build(deps): Bump tauri-build (#199)
Bumps the cargo-minor-patch group in /web/src-tauri with 1 update: [tauri-build](https://github.com/tauri-apps/tauri).


Updates `tauri-build` from 2.7.2 to 2.7.3
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-build-v2.7.2...tauri-build-v2.7.3)

---
updated-dependencies:
- dependency-name: tauri-build
  dependency-version: 2.7.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-10-20 21:48:12 +07:00
github-actions[bot] bd6fe84b8a Ingest games [2026-10-20 05:16] 2026-10-20 05:16:11 +00:00
f2p-tracker-admin[bot] 683638583a queue: 7 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-20 05:15:27 +00:00
github-actions[bot] a48e32392e Auto update [2026-10-20] 2026-10-20 00:20:50 +00:00
github-actions[bot] 4995f64668 Snapshot [2026-10-19] 2026-10-19 23:15:24 +00:00
github-actions[bot] 52639a0a0f Refresh all-time peaks [2026-10-19] 2026-10-19 19:47:14 +00:00
github-actions[bot] 33cbccbf01 Refresh store data [2026-10-19] 2026-10-19 17:15:18 +00:00
github-actions[bot] 34ed67de1a Ingest games [2026-10-19 10:31] 2026-10-19 10:31:12 +00:00
f2p-tracker-admin[bot] cd3824cb3f queue: 5 auto-approved games
Approved automatically by the /admin schedule (at most 500 a day), enabled by admin.

Queued for scripts/ingest_new.py, which decides whether each game is actually free, reachable and not already present. This commit is a request, not a publication.
2026-10-19 10:30:35 +00:00
github-actions[bot] 775fbab6c8 Purge unhealthy [2026-10-19] 2026-10-19 10:20:08 +00:00
dependabot[bot]andpoli0981 5b3238d39c build(deps): Bump the npm-minor-patch group in /web with 8 updates (#194)
Bumps the npm-minor-patch group in /web with 8 updates:

| Package | From | To |
| --- | --- | --- |
| [@lucide/svelte](https://github.com/lucide-icons/lucide/tree/HEAD/packages/svelte) | `1.54.0` | `1.57.0` |
| [@tanstack/svelte-virtual](https://github.com/TanStack/virtual/tree/HEAD/packages/svelte-virtual) | `3.13.40` | `3.13.46` |
| [@tauri-apps/api](https://github.com/tauri-apps/tauri) | `2.12.2` | `2.12.4` |
| [@tauri-apps/plugin-shell](https://github.com/tauri-apps/plugins-workspace) | `2.4.1` | `2.5.0` |
| [@tauri-apps/plugin-updater](https://github.com/tauri-apps/plugins-workspace) | `2.13.2` | `2.14.0` |
| [@tauri-apps/cli](https://github.com/tauri-apps/tauri) | `2.12.1` | `2.12.3` |
| [vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest) | `5.0.3` | `5.0.5` |
| [wrangler](https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler) | `4.149.0` | `4.151.0` |


Updates `@lucide/svelte` from 1.54.0 to 1.57.0
- [Release notes](https://github.com/lucide-icons/lucide/releases)
- [Commits](https://github.com/lucide-icons/lucide/commits/1.57.0/packages/svelte)

Updates `@tanstack/svelte-virtual` from 3.13.40 to 3.13.46
- [Release notes](https://github.com/TanStack/virtual/releases)
- [Changelog](https://github.com/TanStack/virtual/blob/main/packages/svelte-virtual/CHANGELOG.md)
- [Commits](https://github.com/TanStack/virtual/commits/@tanstack/svelte-virtual@3.13.46/packages/svelte-virtual)

Updates `@tauri-apps/api` from 2.12.2 to 2.12.4
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/@tauri-apps/api-v2.12.2...@tauri-apps/api-v2.12.4)

Updates `@tauri-apps/plugin-shell` from 2.4.1 to 2.5.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.4.1...fs-v2.5.0)

Updates `@tauri-apps/plugin-updater` from 2.13.2 to 2.14.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/updater-v2.13.2...updater-v2.14.0)

Updates `@tauri-apps/cli` from 2.12.1 to 2.12.3
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/@tauri-apps/cli-v2.12.1...@tauri-apps/cli-v2.12.3)

Updates `vitest` from 5.0.3 to 5.0.5
- [Release notes](https://github.com/vitest-dev/vitest/releases)
- [Changelog](https://github.com/vitest-dev/vitest/blob/main/docs/releases.md)
- [Commits](https://github.com/vitest-dev/vitest/commits/v5.0.5/packages/vitest)

Updates `wrangler` from 4.149.0 to 4.151.0
- [Release notes](https://github.com/cloudflare/workers-sdk/releases)
- [Commits](https://github.com/cloudflare/workers-sdk/commits/wrangler@4.151.0/packages/wrangler)

---
updated-dependencies:
- dependency-name: "@lucide/svelte"
  dependency-version: 1.57.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: "@tanstack/svelte-virtual"
  dependency-version: 3.13.46
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/api"
  dependency-version: 2.12.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/plugin-shell"
  dependency-version: 2.5.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/plugin-updater"
  dependency-version: 2.14.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/cli"
  dependency-version: 2.12.3
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: vitest
  dependency-version: 5.0.5
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: wrangler
  dependency-version: 4.151.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-10-19 11:56:42 +07:00
dependabot[bot] 7094a6aa9f build(deps): Bump the cargo-minor-patch group (#193)
Bumps the cargo-minor-patch group in /web/src-tauri with 5 updates:

| Package | From | To |
| --- | --- | --- |
| [serde_json](https://github.com/serde-rs/json) | `1.0.151` | `1.0.154` |
| [tauri-plugin-shell](https://github.com/tauri-apps/plugins-workspace) | `2.4.1` | `2.5.0` |
| [tauri-plugin-updater](https://github.com/tauri-apps/plugins-workspace) | `2.13.2` | `2.14.0` |
| [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace) | `2.5.2` | `2.5.4` |
| [tauri-build](https://github.com/tauri-apps/tauri) | `2.7.1` | `2.7.2` |


Updates `serde_json` from 1.0.151 to 1.0.154
- [Release notes](https://github.com/serde-rs/json/releases)
- [Commits](https://github.com/serde-rs/json/compare/v1.0.151...v1.0.154)

Updates `tauri-plugin-shell` from 2.4.1 to 2.5.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.4.1...fs-v2.5.0)

Updates `tauri-plugin-updater` from 2.13.2 to 2.14.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/updater-v2.13.2...updater-v2.14.0)

Updates `tauri-plugin-single-instance` from 2.5.2 to 2.5.4
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.5.2...http-v2.5.4)

Updates `tauri-build` from 2.7.1 to 2.7.2
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-build-v2.7.1...tauri-build-v2.7.2)

---
updated-dependencies:
- dependency-name: serde_json
  dependency-version: 1.0.154
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-shell
  dependency-version: 2.5.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-updater
  dependency-version: 2.14.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-single-instance
  dependency-version: 2.5.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
- dependency-name: tauri-build
  dependency-version: 2.7.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-19 11:45:09 +07:00
github-actions[bot] 25d8deec0c chore(data): mark dead games 2026-10-19 04:43:02 +00:00
poli0981 bda3d4380c Merge pull request #198 from poli0981/ci/updater-json-urls
ci: fix desktop latest.json URLs after tauri-action v1; scope SonarCloud
2026-10-19 11:03:28 +07:00
poli0981andClaude Opus 5.5 3145ed2f1a fix: SonarCloud's findings on the updater-json job
- scripts/updater_json.py takes no file path from the command line any more,
  only the tag; it reads latest.json, assets.json and the .sig files from
  the working directory and rewrites latest.json there
  (pythonsecurity:S8707, path traversal from CLI arguments). The job runs it
  inside its work directory. New test for main().
- release-desktop.yml asks for nothing at workflow level and gives each of
  its two jobs the `contents: write` it needs (githubactions:S8233: with a
  second job, a workflow-level write reached both by default).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 11:01:50 +07:00
poli0981andClaude Opus 5.5 37f1783e90 chore(sonar): scope SonarCloud's automatic analysis
.sonarcloud.properties tells SonarCloud what is code, what is test code and
what to skip. Both start at the root and are split by patterns:

- tests: scripts/tests, every *.test.ts, and what only tests and the admin's
  dev server use (lib/testing, worker/testing, admin/mock) - analysed with
  the test rules, out of duplication and coverage;
- not analysed: the dataset and pipeline-written files (data/, games/,
  *.jsonl), the D1 migrations (SQLite, which the PL/SQL analyser parsed as
  Oracle), web/src/app.html (SvelteKit's template; its <title> arrives via
  %sveltekit.head%), and what the Tauri CLI generated and nobody edits
  (Android res/, buildSrc/, the icon set). The manifest, Gradle build files
  and MainActivity.kt stay in.

Simulated on the tracked files: 219 code, 84 tests, 16 excluded, none
indexed twice. Takes effect once on main. Also an [Unreleased] CHANGELOG
entry for this and the updater-json job, and the rule in CLAUDE.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 10:58:51 +07:00
poli0981andClaude Opus 5.5 a04f24abb6 ci: point every desktop release's latest.json at its download URLs
tauri-action v1 (Dependabot moved release-desktop.yml from v0 after 2.2.0)
writes each artefact's API URL (api.github.com/repos/<repo>/releases/
assets/<id>) into latest.json, and has no setting to change that. The
desktop updater feed accepts only this release's download URLs and answers
204 to anything else, so desktop-v2.2.1 was offered to no installed app
until its latest.json was fixed by hand.

A new `updater-json` job runs after every platform's build: it downloads
latest.json and the .sig files, rewrites each URL to
github.com/<repo>/releases/download/<tag>/<file> (scripts/updater_json.py,
which refuses a version that is not the tag's, an asset of another release,
any other URL shape, or a signature that is not its file's .sig), and
uploads it back. Run on 2.2.1's original file it produces exactly the
hand-fixed one, and a second run changes nothing. Also renames the v0
input includeUpdaterJson to v1's uploadUpdaterJson (same default).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 10:57:41 +07:00
357 changed files with 463062 additions and 13960 deletions

No files matched your search

+4 -3
View File
@@ -15,11 +15,12 @@
CODE_OF_CONDUCT.md export-ignore
CONTRIBUTING.md export-ignore
SECURITY.md export-ignore
/docs/Contact.md export-ignore
/docs/PRIVACY_POLICY.md export-ignore
ACCESSIBILITY.md export-ignore
CHANGELOG.md export-ignore
changelog/ export-ignore
README.md export-ignore
/docs/ToS.md export-ignore
# The legal documents stay IN the archive: the web build reads all of them
# (web/build/legal-versions.ts) and stops when one is missing.
*.csv export-ignore
*.log export-ignore
+75
View File
@@ -0,0 +1,75 @@
name: ♿ Accessibility barrier
description: Something on the site or in the apps you can't use, or can only use with trouble - keyboard, screen reader, zoom, contrast, motion
title: "[A11y] "
labels: ["accessibility"]
body:
- type: markdown
attributes:
value: |
Thanks for telling me. You don't have to say anything about yourself or why - just what got in the way.
Screenshots and recordings are welcome, never required. Rather not post in public? Email **contact@poli0981.dev**.
Not an accessibility problem? **Bug report** is the form you want.
How these reports are handled: [ACCESSIBILITY.md](https://github.com/poli0981/free-steam-games-list/blob/main/ACCESSIBILITY.md).
- type: dropdown
id: surface
attributes:
label: Where?
options:
- "Website — https://free-steam-games.win/"
- "Desktop app (Windows / macOS / Linux)"
- "Android app"
- "This repository (README, docs, games/*.md leaderboards)"
- "Somewhere else (say below)"
validations:
required: true
- type: input
id: page
attributes:
label: Page or link
description: The address, or the page's name in the app (Games, Settings, a game's page...).
placeholder: https://free-steam-games.win/games/730
- type: textarea
id: barrier
attributes:
label: What were you trying to do, and what got in the way?
description: Plain words are fine. Steps help if it only happens sometimes.
placeholder: |
I wanted to open a game from the Games list with the keyboard only.
Every row takes two Tab presses, and I lost track of which game I was on.
validations:
required: true
- type: dropdown
id: impact
attributes:
label: How much does it get in the way?
options:
- "I can't do it at all"
- "I can, but it's hard or slow"
- "Annoying, but I can live with it"
- "Not sure"
validations:
required: true
- type: input
id: assistive-tech
attributes:
label: Assistive technology or settings (optional)
description: e.g. NVDA, Narrator, VoiceOver on iOS, TalkBack, keyboard only, 200% zoom, high contrast, reduce motion.
- type: input
id: environment
attributes:
label: Browser or app version, and OS (optional)
description: The app version shows as "Steam · v…" under "F2P Tracker" in the sidebar (in the menu on small screens).
placeholder: Firefox on Windows 11 · v2.5.0
- type: textarea
id: extra
attributes:
label: Anything else? (optional)
description: A workaround you found, or a screenshot or recording if you'd like to add one.
+39
View File
@@ -0,0 +1,39 @@
name: ➕ Add Games
description: A free-to-play Steam game that is missing from the list (max 10)
title: "[Add Games] "
labels: [ "add-game" ]
body:
- type: markdown
attributes:
value: |
Thanks for the tip! New free games are found on Steam automatically every day,
so most turn up on their own within a few days. Use this for one that is still missing.
Every game is fetched from Steam and checked (free, a game, reachable) before it is listed.
- type: textarea
id: games
attributes:
label: Games to add (Steam store links, one per line, max 10)
description: A store link or a bare appid. Nothing else is needed, the rest comes from Steam.
placeholder: |
https://store.steampowered.com/app/730/
https://store.steampowered.com/app/570/
validations:
required: true
- type: textarea
id: notes
attributes:
label: Anything worth knowing? (optional)
description: e.g. "safe, played 50 h", "kernel anti-cheat", "servers shut down in 2027". Public, like everything here.
- type: checkboxes
id: terms
attributes:
label: Final check
description: Spam/off-topic requests ignored by default. Good luck bro :))
options:
- label: These games are free to play on Steam right now - not a demo, not DLC, not a paid game
required: true
- label: I searched the site and they are not listed yet
required: true
+19 -16
View File
@@ -1,5 +1,5 @@
name: 🐛 Bug Report
description: Report a bug or wrong data (broken thumbnail, wrong genre, web app issue, etc.)
description: Something is broken (web app, desktop or Android app, stale or wrong numbers, broken thumbnail)
title: "[Bug] "
labels: ["bug"]
body:
@@ -7,8 +7,10 @@ body:
attributes:
value: |
Thanks for reporting! This broke unemployed dev will check when caffeine kicks in :))
For things that aren't bugs (just a missing game / wrong genre), the **Add games** or
**Delete game** templates are usually faster.
The project is in maintenance mode: a bug gets a fix, a wish does not get a feature.
For things that aren't bugs: a missing game uses **Add games**, a wrong genre, type,
anti-cheat or note **Edit game**, a game that should go **Delete games**, and something
you can't use with a keyboard, a screen reader or zoom has its own **Accessibility barrier** form.
- type: dropdown
id: surface
@@ -17,7 +19,10 @@ body:
description: Helps me figure out which layer to look at first.
options:
- "Web app — https://free-steam-games.win/"
- "Desktop app (Windows / macOS / Linux)"
- "Android app"
- "Top online — games/top-online.md"
- "Top offline — games/top-offline.md"
- "Raw data — data/data_*.jsonl"
- "API / direct fetch"
- "Other (describe below)"
@@ -30,14 +35,12 @@ body:
label: What kind of bug?
description: Check all that apply (multiple OK).
options:
- label: Wrong game name / genre / metadata
- label: Wrong or stale data from Steam (name, tags, languages, dates)
- label: Broken or dead link
- label: Thumbnail not showing
- label: Reviews / players not updating
- label: Wrong game count / total
- label: Table / chart layout broken
- label: Edit / Add / Delete failed (web app)
- label: GPG signature unverified (web app)
- label: Service worker / offline cache issue
- label: Dropdown / form validation issue
- label: Mobile-specific
@@ -49,8 +52,8 @@ body:
label: Describe the bug
description: |
What happened? Which game(s) or page(s)? How many records affected?
If it's a web-app bug, include the URL after the hash (e.g.
`#/games/730` or `#/charts/anti-cheat`).
If it's a web-app bug, include the page address (e.g.
`https://free-steam-games.win/games/730` or `/charts/anti-cheat`).
validations:
required: true
@@ -60,10 +63,10 @@ body:
label: Steps to reproduce
description: How can I see the bug? Numbered list works great.
placeholder: |
1. Open #/games
1. Open /games
2. Filter genre = FPS
3. Click row "Counter-Strike 2"
4. Edit drawer fails to open
3. Click the row "Counter-Strike 2"
4. The game page shows no player count
- type: textarea
id: screenshots
@@ -71,8 +74,8 @@ body:
label: Screenshots / links
description: |
Paste image URLs (drag-drop into this field works) or links to the
affected commit / row / chart. The web app supports per-game
permalinks — `https://poli0981.github.io/free-steam-games-list/#/games/{appid}`.
affected commit / row / chart. The web app has a page per game —
`https://free-steam-games.win/games/{appid}`.
- type: input
id: env-browser
@@ -84,9 +87,9 @@ body:
- type: input
id: env-version
attributes:
label: Web app version (for web app bugs)
description: Hover the F2P Tracker title in the sidebar — it shows the version.
placeholder: v0.1
label: App version (web, desktop or Android)
description: Shown as "Steam · v…" under the F2P Tracker title in the sidebar (in the menu on small screens).
placeholder: v2.5.0
- type: textarea
id: console
+11
View File
@@ -0,0 +1,11 @@
# The repository is in maintenance mode (CONTRIBUTING.md): issues are for the
# data, for something broken and for accessibility barriers. Everything else
# is sent elsewhere, and blank issues are off so nothing bypasses the forms.
blank_issues_enabled: false
contact_links:
- name: 🔒 Security vulnerability
url: https://github.com/poli0981/free-steam-games-list/security/advisories/new
about: Report it privately, never as a public issue. See SECURITY.md.
- name: 💬 Questions, feedback, chit-chat
url: https://github.com/poli0981/free-steam-games-list/discussions
about: Discussions. Feature requests are not taken - the project is stable and in maintenance mode.
+60
View File
@@ -0,0 +1,60 @@
name: ✏️ Edit Game
description: A listed game has something wrong (genre, type, anti-cheat, notes, safe)
title: "[Edit Game] "
labels: [ "edit-game" ]
body:
- type: markdown
attributes:
value: |
Thanks for the correction! It is recorded as an override, which every pipeline run keeps.
Only the human-judged fields can be corrected here. Name, tags, languages, reviews and
player counts are whatever Steam says and are refreshed from Steam - if one of those
is stale or wrong, use **Bug report** instead.
- type: input
id: game
attributes:
label: Game (Steam store link or page on the site)
placeholder: https://store.steampowered.com/app/730/
validations:
required: true
- type: checkboxes
id: fields
attributes:
label: What is wrong?
description: Check all that apply.
options:
- label: Genre
- label: Type (online / offline)
- label: Anti-cheat (product, or kernel-level or not)
- label: Safe (y / n / ?)
- label: Notes
validations:
required: true
- type: textarea
id: change
attributes:
label: What should it say?
description: Current value → correct value, per field.
placeholder: |
genre: Casual → RTS
anti_cheat: none → Easy Anti-Cheat (kernel)
validations:
required: true
- type: textarea
id: source
attributes:
label: How do you know? (optional but helpful)
description: A link to the store page, the developer's announcement, or "I play it". Public, like everything here.
- type: checkboxes
id: terms
attributes:
label: Final check
description: Spam/off-topic requests ignored by default. Good luck bro :))
options:
- label: I agree – this is a correction to a game on the list
required: true
@@ -1,68 +0,0 @@
name: 💡 Feature Request / Improvement
description: Suggest new feature or improve existing one
title: "[Feature] "
labels: [ "enhancement" ]
body:
- type: markdown
attributes:
value: |
Thanks for the idea! This noob dev appreciates it (Grok buddy will help code :)))
- type: checkboxes
id: type
attributes:
label: Type (choose one only)
options:
- label: New feature
- label: Improvement to existing code/feature
validations:
required: true
- type: input
id: title
attributes:
label: Feature/Improvement name
description: Short title (e.g., "Add peak players column")
validations:
required: true
- type: textarea
id: reason
attributes:
label: Why? Reason
description: How does it help? (e.g., "Current tables load slow with 200+ games")
validations:
required: true
- type: checkboxes
id: priority
attributes:
label: Priority level (choose one only)
options:
- label: Not urgent (nice to have)
- label: Could be useful
- label: Very needed
- label: Urgent af
validations:
required: true
- type: textarea
id: description
attributes:
label: How it works? (optional)
description: More details or example
- type: textarea
id: code
attributes:
label: Code snippet/mockup (optional – no malware pls, I'll check though lazy :D)
render: python
- type: checkboxes
id: terms
attributes:
label: Final check
description: Off-topic/spam ignored by default. Good luck bro :))
options:
- label: I agree – this is on-topic
required: true
-37
View File
@@ -1,37 +0,0 @@
name: 📢 Feedback / Rant
description: General feedback, complaints, or suggestions not fitting other templates
title: "[Feedback] "
labels: [ "feedback" ]
body:
- type: markdown
attributes:
value: |
Spill it bro – good, bad, ugly. This noob dev reads (sometimes :)))
- type: textarea
id: feedback
attributes:
label: Your feedback
description: Docs too strict? Contributing guidelines wrong? Copyright issue? Repo like shit? Something else?
validations:
required: true
- type: checkboxes
id: common
attributes:
label: Common issues? (optional, check all)
options:
- label: Docs too harsh/complicated
- label: Contributing rules wrong
- label: Possible copyright/problematic game
- label: Repo sucks / needs total overhaul
- label: Other (described above)
- type: checkboxes
id: terms
attributes:
label: Final check
description: Off-topic/spam/rude stuff ignored by default. Good luck :))
options:
- label: I agree – this is real feedback
required: true
-26
View File
@@ -1,26 +0,0 @@
name: ❓ Off-Topic / Other
description: Anything not bug/feature/add-game
title: "[Other] "
labels: ["off-topic"]
body:
- type: markdown
attributes:
value: |
For random stuff, questions, chit-chat. But if off-topic/spam/violate policy – ignored by default :))
- type: textarea
id: description
attributes:
label: What is it?
description: Go ahead bro
validations:
required: true
- type: checkboxes
id: terms
attributes:
label: Final check
description: I understand this might be ignored. Good luck :))
options:
- label: I agree
required: true
+16 -7
View File
@@ -34,8 +34,8 @@ updates:
patterns: ['@tauri-apps/*']
ignore:
# Framework majors are migrations with their own staged PRs, not
# something to take as an unattended bump. (SvelteKit 3 needs the
# cookie override in package.json re-keyed or dropped; see CLAUDE.md.)
# something to take as an unattended bump (SvelteKit 3 moved its config,
# its $lib alias, its param matchers and the PWA wiring; see CLAUDE.md).
- dependency-name: '@sveltejs/kit'
update-types: [version-update:semver-major]
- dependency-name: '@sveltejs/adapter-static'
@@ -44,10 +44,17 @@ updates:
update-types: [version-update:semver-major]
- dependency-name: tailwindcss
update-types: [version-update:semver-major]
# `typescript` must stay 6: svelte-check and `svelte-kit sync` need the
# JavaScript API that TypeScript 7 does not have. TypeScript 7 is the
# `@typescript/native` alias (npm:typescript@~7.0.x), bumped by hand with
# it - Dependabot mishandles `npm:` aliases (dependabot-core #16488).
# See CLAUDE.md, docs/plan/16-toolchain-2026.md and, for the day 7.1
# lets TypeScript 6 go, docs/plan/17-typescript-7.1.md.
- dependency-name: typescript
update-types: [version-update:semver-major]
# The type definitions follow the Node the build runs on (24, in
# web-ci.yml and the release workflows), not the newest Node.
- dependency-name: '@typescript/native'
# The type definitions follow the Node the build runs on (web/.node-version,
# which every setup-node repeats), not the newest Node.
- dependency-name: '@types/node'
update-types: [version-update:semver-major]
@@ -92,9 +99,11 @@ updates:
actions-all:
patterns: ['*']
ignore:
# Action majors are held until the GITHUB_TOKEN checkout migration is
# confirmed green — do not stack an untested action-major bump on top
# of a credential change you still need to verify.
# Majors of these two are taken by hand, for every workflow at once: the
# data jobs that check out, commit and push run only on a schedule, so a
# pull request's CI never exercises them. Keep ONE major across all
# workflows - the Node 20 ones (checkout v4, setup-python v5) printed a
# deprecation warning on every run until 2026-10-26.
- dependency-name: actions/checkout
update-types: [version-update:semver-major]
- dependency-name: actions/setup-python
+49
View File
@@ -0,0 +1,49 @@
<!--
Thanks for the PR! One person reviews these by hand, so a short "what and why" goes a long way.
Everything here is public and permanent: keep personal info (email, real name, account IDs) out of it.
Written with an AI assistant? Fine - so was most of this repo. You still checked the boxes yourself.
Delete the sections that don't apply.
The project is stable and in maintenance mode (CONTRIBUTING.md). A pull request is merged when it is:
- data: a game added, corrected or removed;
- a security fix (report it privately first, SECURITY.md);
- a runtime or dependency update, or the repair of what one broke.
New features are not taken.
-->
## What and why
<!-- A sentence or two. "Closes #123" if it fixes an issue. -->
## Kind of change
- [ ] Data: add a game (`scripts/temp_info.jsonl`)
- [ ] Data: correct a game (`data/overrides/<appid>.json`, written by `scripts/edit_game.py`)
- [ ] Data: remove a game (`data/blocklist.jsonl`, written by `scripts/delete_game.py`)
- [ ] Security fix
- [ ] Runtime / dependency update, or a fix for what one broke
- [ ] Docs
## Checks
- [ ] Web (`web/`): `npm run typecheck && npm test && npm run build && node scripts/verify-dist.mjs --web`
- [ ] Pipeline (`scripts/`): `python -m pytest scripts/tests`
- [ ] Overrides or blocklist: `python scripts/edit_game.py --check` / `python scripts/delete_game.py --check`
- [ ] Docs or queued links only - nothing to run
- [ ] No hand edit to `data/data_*.jsonl` or `data/index.json`
## Accessibility (only if the interface changed)
The longer version is in [ACCESSIBILITY.md](https://github.com/poli0981/free-steam-games-list/blob/main/ACCESSIBILITY.md#for-contributors).
- [ ] Works with the keyboard alone, and focus stays visible
- [ ] Controls and icon buttons have a name a screen reader can read; images have `alt` (`alt=""` when decorative)
- [ ] Nothing new is shown by colour or a hover tooltip alone, and text stays readable in both themes
- [ ] Still usable 360 px wide, at 200% zoom and with reduce motion on
- [ ] No new `svelte-ignore a11y_*`, or the description says why
- [ ] New text is in both `en.json` and `vi.json`
## Queued games (`scripts/temp_info.jsonl`)
- [ ] One store link per line, nothing else
- [ ] Free to play on Steam right now - not a demo, not a paid game
@@ -80,7 +80,7 @@ jobs:
'',
'---',
'',
'*(Auto-posted by `.github/workflows/announce-release-discussion.yml`. Reply with feedback, install issues, or feature requests — full bug reports still go through the [issue templates](../../issues/new/choose).)*',
'*(Auto-posted by `.github/workflows/announce-release-discussion.yml`. Reply with feedback or install issues. The project is in maintenance mode, so feature requests are not taken — bug reports and data changes go through the [issue templates](../../issues/new/choose).)*',
]
.filter(Boolean)
.join('\n');
+20 -7
View File
@@ -3,10 +3,15 @@ name: Backfill Discovery (TEMPORARY)
# >>> TEMPORARY. DELETE THIS FILE AND scripts/backfill_discover.py ONCE THE
# >>> HISTORICAL BACKLOG HAS BEEN WORKED THROUGH.
#
# Measured 2026-09-10: Steam lists 16,668 free games matching the catalogue's
# own filters; data/ holds 3,424. This workflow chews through that gap one
# release window at a time. `Discover New Games` covers everything from today
# forward and is permanent -- this one is not.
# Measured 2026-09-10: Steam listed 16,668 free games that support English;
# data/ held 3,424. This workflow chews through that gap one release window at
# a time. `Discover New Games` covers everything from today forward and is
# permanent -- this one is not.
#
# Since v4.6.0 discovery takes games in every language (18,790 free games on
# 2026-10-30, 1,592 of them without English), so a window swept before then
# needs one more pass. A whole recent year is ~30 search pages; a window is
# done only when the log says "walked past the window".
#
# Same propose-only contract as the daily job: `contents: read`, and the same
# guard step asserting no dataset-writing helper is reachable.
@@ -29,6 +34,10 @@ on:
description: 'Max candidates to propose in one run'
required: false
default: '250'
max_pages:
description: 'Search pages to walk once the window is found (100 rows each; a whole recent year is ~30)'
required: false
default: '40'
dry_run:
description: 'Find candidates but do not POST them'
type: boolean
@@ -51,9 +60,12 @@ permissions:
concurrency:
# Shares the `discovery` group with the daily job on purpose: two sweeps
# hammering Steam's search from the same runner pool is the one way to earn a
# rate limit that hurts both.
# rate limit that hurts both. `queue: max`, like the daily job: windows are
# dispatched several at a time, and the default single waiting slot would
# cancel all but the last.
group: discovery
cancel-in-progress: false
queue: max
jobs:
backfill:
@@ -64,7 +76,7 @@ jobs:
- uses: actions/setup-python@v6
with:
python-version: '3.12'
python-version: '3.15'
- name: Assert discovery cannot write the dataset
run: |
@@ -102,6 +114,7 @@ jobs:
YEAR: ${{ inputs.year }}
QUARTER: ${{ inputs.quarter }}
LIMIT: ${{ inputs.limit || '250' }}
MAX_PAGES: ${{ inputs.max_pages || '40' }}
DRY: ${{ inputs.dry_run && '--dry-run' || '' }}
run: |
# An absent YEAR means this is the scheduled run, so both env defaults
@@ -119,7 +132,7 @@ jobs:
fi
# A blank quarter must be omitted from argv, not passed as an empty
# string: argparse rejects '' as an invalid choice.
args="--year $YEAR --limit $LIMIT"
args="--year $YEAR --limit $LIMIT --max-pages $MAX_PAGES"
if [ -n "$QUARTER" ]; then args="$args --quarter $QUARTER"; fi
echo "backfill_discover.py $args $DRY"
python scripts/backfill_discover.py $args $DRY
-19
View File
@@ -1,19 +0,0 @@
name : Check Dead Links
on :
schedule : [ { cron : '0 4 1,6,11,16,21,26 * *' } ]
workflow_dispatch :
permissions : { contents : write }
concurrency :
group : data-write
cancel-in-progress : false
jobs :
check :
runs-on : ubuntu-latest
steps :
-
uses : actions/checkout@v6
-
uses : actions/setup-python@v6
with : { python-version : '3.12' }
-
run : chmod +x ./bash/dead_links.sh && ./bash/dead_links.sh
+2 -2
View File
@@ -63,7 +63,7 @@ jobs:
- uses: actions/checkout@v6
- uses: actions/setup-python@v6
with:
python-version: '3.12'
python-version: '3.15'
- run: |
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
- name: Validate every override
@@ -74,7 +74,7 @@ jobs:
# a formatting change on either side fails here.
- uses: actions/setup-node@v7
with:
node-version: '24'
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
- name: Install web deps
+7 -2
View File
@@ -73,13 +73,18 @@ jobs:
steps:
- name: Checkout
uses: actions/checkout@v4
uses: actions/checkout@v6
# The one workflow not on the pipeline's Python (3.15, every other
# setup-python): CodeQL's supported-languages page lists Python up to
# 3.14, and its extractor runs on this interpreter. The pipeline uses no
# 3.15-only syntax, so nothing goes unparsed. web/shared/toolchain.test.ts
# names this exception; move it when CodeQL lists 3.15.
- name: Setup Python
if: matrix.language == 'python'
uses: actions/setup-python@v6
with:
python-version: '3.12'
python-version: '3.14'
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
+1 -1
View File
@@ -37,7 +37,7 @@ jobs:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v4
- uses: actions/checkout@v6
- name: Upload redirect page
uses: actions/upload-pages-artifact@v5
+8 -2
View File
@@ -34,11 +34,17 @@ permissions:
concurrency:
# Its own group, NOT `data-write`: this job writes nothing to the repo, so
# queueing it behind the ~115-minute data jobs would delay discovery for no
# queueing it behind the long data jobs would delay discovery for no
# benefit. Two overlapping discovery runs are the only real hazard, and this
# covers that.
#
# `queue: max` keeps every waiting run (up to 100, first in, first out).
# Without it the group keeps ONE: a third run - a backfill dispatched while
# another waits - cancels the one already waiting. Every member of the group
# says the same (Backfill Discovery too); web/shared/pipeline.test.ts holds it.
group: discovery
cancel-in-progress: false
queue: max
jobs:
discover:
@@ -49,7 +55,7 @@ jobs:
- uses: actions/setup-python@v6
with:
python-version: '3.12'
python-version: '3.15'
# Belt-and-braces for the propose-only guarantee above. `contents: read`
# already blocks a push, but this fails the job at the point the intent is
+16 -11
View File
@@ -5,26 +5,31 @@ on :
# fires the ingest on a detached HEAD, and dies with exit 128 on push.
#
# data/blocklist.jsonl is here too: this job also applies removals
# (bash/ingest.sh runs scripts/remove_games.py first). A separate removal
# workflow would share `data-write` with this one, and each would evict the
# other's pending run.
# (bash/ingest.sh runs scripts/remove_games.py first), so one run does both.
push : { branches : [ main ], paths : [ 'scripts/temp_info.jsonl', 'data/blocklist.jsonl' ] }
# Orphan recovery, not a poll. `data-write` keeps at most ONE run pending and
# cancels the older one, so a push here that queues behind a ~115-minute data
# job is silently evicted the moment any OTHER data-write workflow queues --
# and nothing retries it, leaving approved games sitting in temp_info.jsonl
# until the next unrelated push. Re-running on a clear file is free:
# ingest_new.py returns immediately and `git diff --staged --quiet` skips the
# commit, so this is idempotent by construction.
# A safety net, not a poll. Before data-write queued its runs (queue: max),
# a push here that waited behind a long data job was evicted the moment any
# other data-write workflow queued, and approved games sat in
# temp_info.jsonl until the next unrelated push. Nothing is evicted now, but
# a failed run still leaves its links queued. Re-running on a clear file is
# free: ingest_new.py returns immediately and `git diff --staged --quiet`
# skips the commit, so this is idempotent by construction.
schedule : [ { cron : '0 */3 * * *' } ]
workflow_dispatch :
permissions : { contents : write }
# queue: max - a run that finds another data job running waits its turn
# (first in, first out) instead of evicting the run already waiting.
concurrency :
group : data-write
cancel-in-progress : false
queue : max
jobs :
ingest :
runs-on : ubuntu-latest
# About seven seconds a game, and an /admin batch holds at most 100. No
# time budget: ingest_new.py empties the whole queue file when it is done,
# so a game it had not reached would be lost.
timeout-minutes : 120
steps :
-
uses : actions/checkout@v6
@@ -35,7 +40,7 @@ jobs :
with : { ref : main }
-
uses : actions/setup-python@v6
with : { python-version : '3.12' }
with : { python-version : '3.15' }
-
run : chmod +x ./bash/ingest.sh && ./bash/ingest.sh
env : { STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}' }
+7 -3
View File
@@ -19,23 +19,27 @@ permissions:
contents: write
actions: write
# queue: max - a run that finds another data job running waits its turn
# (first in, first out) instead of evicting the run already waiting.
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
mark:
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v4
- uses: actions/checkout@v6
# The tip of main when the job starts, not when it was queued: a run
# that waited behind a long data job would otherwise rewrite stale shards.
with:
ref: main
- uses: actions/setup-python@v5
- uses: actions/setup-python@v6
with:
python-version: '3.12'
python-version: '3.15'
cache: 'pip'
cache-dependency-path: requirements.txt
-1
View File
@@ -13,7 +13,6 @@ on:
- "Auto Update JSON Data"
- "Top Online Leaderboard"
- "Update Reviews"
- "Check Dead Links"
- "Purge Unhealthy Games"
- "Ingest New Game Links"
- "Force Re-fetch All (v2.1 Schema)"
+28 -3
View File
@@ -1,20 +1,45 @@
name : Purge Unhealthy Games
# Takes out the games that left the store, stopped being free or are not out
# yet - only when two of Steam's answers agree: IStoreBrowseService/GetItems
# screens the whole catalogue in a hundred-odd requests, and appdetails
# confirms each game it flags (scripts/purge_unhealthy.py has the rules and
# the guards). A few minutes, so it runs daily. It replaces both the old
# purge (appdetails for every game, 5.3 hours) and Check Dead Links, a 5.5-hour
# HEAD sweep that never found anything: Steam sends a delisted app's page to
# the store front, which answers 200.
on :
schedule : [ { cron : '0 5 * * 1' } ]
schedule : [ { cron : '0 7 * * *' } ]
workflow_dispatch :
inputs :
dry_run :
description : 'Dry run: screen and confirm, remove nothing'
type : boolean
default : false
permissions : { contents : write }
# queue: max - a run that finds another data job running waits its turn
# (first in, first out) instead of evicting the run already waiting.
concurrency :
group : data-write
cancel-in-progress : false
queue : max
jobs :
purge :
runs-on : ubuntu-latest
timeout-minutes : 60
steps :
-
uses : actions/checkout@v6
# main as it is when the job STARTS: a run that waited its turn must
# work on what the job before it committed.
with : { ref : main }
-
uses : actions/setup-python@v6
with : { python-version : '3.12' }
with : { python-version : '3.15' }
-
run : chmod +x ./bash/purge.sh && ./bash/purge.sh
env : { STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}' }
env :
STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}'
JOB_BUDGET_MINUTES : '40'
PURGE_DRY_RUN : ${{ inputs.dry_run }}
+1 -1
View File
@@ -28,7 +28,7 @@ jobs:
- uses: actions/checkout@v6
- uses: actions/setup-python@v6
with:
python-version: '3.12'
python-version: '3.15'
# The data pipeline's own install line, exactly as bash/*.sh run it, so a
# Dependabot bump of requirements.txt is proven here before a data job
# meets it. Hash mode is all-or-nothing per pip call, hence the second
+219
View File
@@ -0,0 +1,219 @@
# Qodana (JetBrains) static analysis, one linter per Qodana Cloud project:
#
# typescript - qodana-js web/ https://qodana.cloud/projects/GgGyE
# python - qodana-python scripts/ https://qodana.cloud/projects/P2R5k
# rust - qodana-rust web/src-tauri/ https://qodana.cloud/projects/40daO
#
# Each project has its own token (a repository secret) and its own settings
# file (the qodana.yaml in the directory above). Every run analyses the whole
# project (`pr-mode: false`), so a pull request and `main` report the same way.
# All three are Ultimate linters (Qodana for Rust is also Early Access): when
# the licence ends, every job fails on it - renew it, or delete this file and
# the three qodana.yaml files.
#
# Dependabot and fork PRs get no repository secrets: the analysis is skipped
# there, not failed (the `tokens` job). Dependencies are installed before the
# scan, in steps that don't see the token.
name: Qodana
on:
push:
branches: [main]
# Data commits (the pipeline's, the admin Worker's) and docs change no code.
paths-ignore:
- 'data/**'
- 'games/**'
- 'scripts/*.jsonl'
- 'scripts/*.log'
- '**.md'
pull_request:
paths-ignore:
- 'data/**'
- 'games/**'
- 'scripts/*.jsonl'
- 'scripts/*.log'
- '**.md'
workflow_dispatch:
permissions: {}
concurrency:
group: qodana-${{ github.ref }}
cancel-in-progress: true
jobs:
tokens:
runs-on: ubuntu-latest
timeout-minutes: 5
permissions: {}
outputs:
present: ${{ steps.check.outputs.present }}
steps:
- name: Check for the Qodana tokens
id: check
env:
HAS_TS_JS: ${{ secrets.QODANA_TOKEN_TS_JS != '' }}
HAS_PYTHON: ${{ secrets.QODANA_TOKEN_PYTHON != '' }}
HAS_RUST: ${{ secrets.QODANA_TOKEN_RUST != '' }}
run: |
if [ "$HAS_TS_JS" = true ] && [ "$HAS_PYTHON" = true ] && [ "$HAS_RUST" = true ]; then
echo "present=true" >> "$GITHUB_OUTPUT"
else
echo "::notice::No Qodana tokens in this run (Dependabot or fork PR): Qodana analysis skipped."
fi
typescript:
name: TypeScript / JavaScript
needs: tokens
if: needs.tokens.outputs.present == 'true'
runs-on: ubuntu-latest
timeout-minutes: 40
permissions:
contents: read
checks: write # the action's annotations
steps:
# The pull request's own head commit, not the merge GitHub makes, so
# the report names a commit that exists; full history for its VCS data.
- uses: actions/checkout@v6
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
fetch-depth: 0
persist-credentials: false
- uses: actions/setup-node@v7
with:
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
# The linter resolves imports and types from node_modules.
# --ignore-scripts, as everywhere this repo runs `npm ci` (web-ci.yml
# says why).
- name: Install web/
working-directory: web
run: npm ci --ignore-scripts
# `svelte-kit sync` writes the tsconfig web/tsconfig.json extends and the
# route types; the admin build writes worker/generated/, which
# worker/index.ts imports. Without them the app reads untyped and the
# Worker has an unresolved import (sonarcloud.yml does the same).
- name: Generate SvelteKit's types and the admin bundle
working-directory: web
run: npm run build:admin
# Docker, not native: the components are .svelte files, which only
# JetBrains' Svelte plugin reads (web/qodana.yaml), and installing a
# plugin fails in native mode with every released CLI up to 2026.2.3
# ("qodana.build.date system property must be set", fixed upstream as
# QD-16701 after that release). The container sees this checkout,
# node_modules and the generated files included.
# --project-dir <subdir> --repository-root . keeps the git data.
- name: Qodana scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --project-dir web --repository-root . --linter qodana-js
pr-mode: false
post-pr-comment: false
upload-result: true
artifact-name: qodana-report-typescript
# The default keys are the same for every job of a run.
primary-cache-key: qodana-2026.2-js-${{ github.ref }}-${{ github.sha }}
additional-cache-key: qodana-2026.2-js-${{ github.ref }}
cache-default-branch-only: true
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_TS_JS }}
python:
name: Python
needs: tokens
if: needs.tokens.outputs.present == 'true'
runs-on: ubuntu-latest
timeout-minutes: 30
permissions:
contents: read
checks: write
steps:
- uses: actions/checkout@v6
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
fetch-depth: 0
persist-credentials: false
- uses: actions/setup-python@v6
with:
python-version: '3.15'
# Hash-locked, wheels only, one pip call per file (hash mode is
# all-or-nothing per call), as python-tests.yml. The tests are analysed
# too, so pytest has to resolve. In native mode the linter finds no
# interpreter by itself (SDKs.json empty: it then calls every
# `dict[str, int]` and `X | None` an invalid type hint): it gets this
# virtual environment through QODANA_PYTHON_PATH below.
- name: Install the pipeline and the test tools
run: |
python -m venv .venv
.venv/bin/pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
.venv/bin/pip install --quiet --require-hashes --only-binary :all: -r requirements-test.txt
# Native mode (scripts/qodana.yaml): the Qodana image would bring an
# older Python. scripts/ is the project: every script and the tests put
# it on sys.path and import `core`, which resolves only when scripts/ is
# the content root.
- name: Qodana scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --project-dir scripts --repository-root . --linter qodana-python --within-docker false
pr-mode: false
post-pr-comment: false
upload-result: true
artifact-name: qodana-report-python
primary-cache-key: qodana-2026.2-python-${{ github.ref }}-${{ github.sha }}
additional-cache-key: qodana-2026.2-python-${{ github.ref }}
cache-default-branch-only: true
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_PYTHON }}
QODANA_PYTHON_PATH: ${{ github.workspace }}/.venv/bin/python
rust:
name: Rust
needs: tokens
if: needs.tokens.outputs.present == 'true'
runs-on: ubuntu-latest
timeout-minutes: 45
permissions:
contents: read
checks: write
steps:
- uses: actions/checkout@v6
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
fetch-depth: 0
persist-credentials: false
# tauri::generate_context!() refuses to expand without the frontend
# directory (frontendDist, ../dist): an empty page stands in for the
# web build, which the analysis does not need.
- name: Stand-in for the web build
run: |
mkdir -p web/dist
echo '<!doctype html><title>stand-in</title>' > web/dist/index.html
# qodana-rust ships only as a Docker image. It runs as root so that its
# bootstrap (web/src-tauri/qodana.yaml) can install the C toolchain and
# the libraries Tauri links against: without them `cargo check` fails
# and the linter loads no Cargo package at all ("Cargo project
# loading"). The crates go to the (cached) Qodana cache directory, which
# the runner's user could not write in the image's own CARGO_HOME.
- name: Qodana scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --project-dir web/src-tauri --repository-root . --linter qodana-rust -u root -e CARGO_HOME=/data/cache/cargo
pr-mode: false
post-pr-comment: false
upload-result: true
artifact-name: qodana-report-rust
primary-cache-key: qodana-2026.2-rust-${{ github.ref }}-${{ github.sha }}
additional-cache-key: qodana-2026.2-rust-${{ github.ref }}
cache-default-branch-only: true
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_RUST }}
+23 -7
View File
@@ -1,16 +1,25 @@
name : Force Re-fetch All (v2.1 Schema)
# ⚠ MANUAL ONLY – this re-fetches ALL games from Steam.
# Takes a long time for large datasets (300+ games ≈ 15-30 min).
# Creates a backup at data.jsonl.bak before starting.
# ⚠ MANUAL ONLY – this re-fetches games from Steam from scratch, about six
# seconds a game: far longer than one job may run once the catalogue is in
# the thousands. Run it in PARTS: part "1/8" takes an eighth of the games
# (crc32 slices, scripts/refetch_all.py), and the runs for 1/8 ... 8/8 can be
# started together - the data-write group queues them (queue: max). A part cut
# short by its budget keeps what it did; starting it again carries on with the
# games it did not reach. Creates a backup at data.bak before starting.
on :
workflow_dispatch :
inputs :
confirm :
description : 'Type "yes" to confirm force re-fetch of ALL games'
description : 'Type "yes" to confirm force re-fetch'
required : true
type : string
part :
description : 'Which part, K/N (1/8 ... 8/8 for the whole catalogue)'
required : true
default : '1/8'
type : string
permissions :
contents : write
@@ -18,27 +27,34 @@ permissions :
concurrency :
group : data-write
cancel-in-progress : false
queue : max
jobs :
refetch :
if : ${{ github.event.inputs.confirm == 'yes' }}
runs-on : ubuntu-latest
timeout-minutes : 120
timeout-minutes : 350
steps :
-
name : Checkout repo
uses : actions/checkout@v6
# main as it is when the job STARTS: a part that waited its turn must
# work on what the part before it committed.
with :
ref : main
-
name : Setup Python
uses : actions/setup-python@v6
with :
python-version : '3.12'
python-version : '3.15'
-
name : Force re-fetch all games
name : Force re-fetch one part
env :
STEAM_API_KEY : ${{ secrets.STEAM_API_KEY }}
REFETCH_PART : ${{ inputs.part }}
JOB_BUDGET_MINUTES : '320'
run : |
chmod +x ./bash/refetch_all.sh
./bash/refetch_all.sh
+18 -11
View File
@@ -1,16 +1,18 @@
name: Refresh All-Time Peaks
# all_time_peak - the most players a game has had at once - from SteamCharts'
# recorded peak, a thirtieth of the catalogue a day (~186 pages, 2-3 s apart:
# about ten minutes), so every game is asked once a month. Every run also
# raises the field from our own Steam API samples, which needs no requests.
# scripts/refresh_peaks.py has the rules: the field only ever goes up, and a
# refusal from SteamCharts ends the run early with a warning, not a failure.
# recorded peak, a thirtieth of the catalogue a day (~330 pages, 2-3 s apart:
# about a quarter of an hour), so every game is asked once a month. Past 400
# pages a day the cycle grows to 60 days and more instead: never more often
# than once a month a game. Every run also raises the field from our own
# Steam API samples, which needs no requests. scripts/refresh_peaks.py has
# the rules: the field only ever goes up, and a refusal from SteamCharts - or
# the time budget running out - ends the run early with a warning, not a
# failure.
#
# 19:30 UTC sits between Refresh Store Data (16:00, ~40 minutes) and the Daily
# Snapshot (23:00), where only the short Ingest runs are due. Scheduled runs
# here start up to a few hours late, and the data-write group keeps only ONE
# pending run, so this stays clear of the long morning jobs.
# 19:30 UTC sits between Refresh Store Data (16:00, about an hour) and the
# Daily Snapshot (23:00). A data job still running only delays this one: the
# data-write group queues runs (queue: max) instead of evicting them.
#
# The one-time backfill is a manual run with the box ticked: every game, about
# four hours. Start it in the evening UTC, after Refresh Store Data.
@@ -30,15 +32,20 @@ permissions: {contents: write}
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
refresh:
runs-on: ubuntu-latest
timeout-minutes: ${{ inputs.backfill && 330 || 30 }}
timeout-minutes: ${{ inputs.backfill && 340 || 45 }}
steps:
# main as it is when the job STARTS: a run that waited its turn must
# work on what the job before it committed.
- uses: actions/checkout@v6
with: {ref: main}
- uses: actions/setup-python@v6
with: {python-version: '3.12'}
with: {python-version: '3.15'}
- run: chmod +x ./bash/refresh_peaks.sh && ./bash/refresh_peaks.sh
env:
PEAKS_ALL: ${{ inputs.backfill }}
JOB_BUDGET_MINUTES: ${{ inputs.backfill && '300' || '25' }}
+14 -9
View File
@@ -5,22 +5,23 @@ name: Refresh Store Data
# store page, every game once a week; name, header image, description,
# developer/publisher, release date, platforms, Metacritic and DRM notes from
# appdetails, every game once a month. Each daily run takes one slice of each
# rotation - roughly 630 store pages and 150 appdetails calls, ~40 minutes.
# rotation - about 1,400 store pages and 330 appdetails calls at 9,800 games,
# an hour. Past 2,000 pages or 500 appdetails a day a cycle doubles instead of
# the run growing, so it stays under an hour and a half.
# scripts/refresh_store_data.py explains the rotation and the rules (never
# blanks a value, never touches MANUAL_FIELDS).
#
# Then the anti-cheat sweep, committed separately: every game's anti-cheat as
# its developer declares it on Steam, about 160 GetItems requests plus a store
# its developer declares it on Steam, about 200 GetItems requests plus a store
# page for each disclosure Steam does not name there (~70), a few minutes.
# scripts/refresh_anticheat.py has its rules: Steam wins, an override wins
# over Steam, and no disclosure never clears a value. `only: anticheat` runs
# just the sweep.
#
# 16:00 UTC is the quiet part of this repository's day. Scheduled runs here
# start two to five hours late, the morning data jobs (reviews, dead links,
# purge) run for two to four hours, and the data-write group keeps only ONE
# pending run: a second one queueing behind a running job cancels the first.
# Nothing else long is due this late; the Daily Snapshot (23:00) comes after.
# 16:00 UTC is the quiet part of this repository's day: scheduled runs here
# start up to an hour late, and the morning jobs are done by then. A data job
# that is still running only delays this one - the data-write group queues
# runs (queue: max) instead of evicting the one waiting.
on:
schedule: [{cron: '0 16 * * *'}]
@@ -38,18 +39,22 @@ permissions: {contents: write}
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
refresh:
runs-on: ubuntu-latest
timeout-minutes: 120
timeout-minutes: 150
steps:
# main, not the triggering commit: a run that waited its turn in
# data-write must work on the data as it is now, not as it was queued.
- uses: actions/checkout@v6
with: {ref: main}
- uses: actions/setup-python@v6
with: {python-version: '3.12'}
with: {python-version: '3.15'}
- run: chmod +x ./bash/refresh_store.sh && ./bash/refresh_store.sh
env:
REFRESH_ONLY: ${{ inputs.only }}
# The store refresh's budget (core/budget.py); the anti-cheat sweep
# after it takes a few minutes and has none.
JOB_BUDGET_MINUTES: '100'
+4 -4
View File
@@ -37,7 +37,7 @@ jobs:
# A manual run builds the tag it is releasing, not whatever main is at by
# then: a re-run after a CI-only fix must not ship newer app code under an
# older version's tag.
- uses: actions/checkout@v5
- uses: actions/checkout@v6
with:
ref: ${{ github.event.inputs.tag || github.ref }}
@@ -55,7 +55,7 @@ jobs:
- uses: actions/setup-node@v7
with:
node-version: '24'
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
@@ -66,7 +66,7 @@ jobs:
toolchain: stable
targets: aarch64-linux-android,armv7-linux-androideabi,i686-linux-android,x86_64-linux-android
- uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
with:
workspaces: 'web/src-tauri -> target'
@@ -134,7 +134,7 @@ jobs:
run: npm run tauri -- android build --apk
- name: Publish APK to GitHub Release
uses: softprops/action-gh-release@efb35369e0ad2afab669f228072c1b0d510eae64 # v3.0.3
uses: softprops/action-gh-release@8a0cd651e5b2365bd640854a3fa5dfc70e4875f3 # v3.0.4
with:
tag_name: ${{ github.event.inputs.tag || github.ref_name }}
name: F2P Tracker Android ${{ github.event.inputs.tag || github.ref_name }}
+46 -6
View File
@@ -11,11 +11,14 @@ on:
required: true
default: 'desktop-v1.0.0'
permissions:
contents: write
# Nothing by default; each job asks for the write it needs (both write to the
# release: the build its artefacts, updater-json latest.json).
permissions: {}
jobs:
build:
permissions:
contents: write
strategy:
fail-fast: false
matrix:
@@ -28,7 +31,7 @@ jobs:
args: ''
runs-on: ${{ matrix.platform }}
steps:
- uses: actions/checkout@v5
- uses: actions/checkout@v6
- name: Install Linux build deps
if: matrix.platform == 'ubuntu-latest'
@@ -47,7 +50,7 @@ jobs:
- uses: actions/setup-node@v7
with:
node-version: '24'
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
@@ -62,7 +65,7 @@ jobs:
toolchain: stable
targets: ${{ matrix.platform == 'macos-latest' && 'aarch64-apple-darwin,x86_64-apple-darwin' || '' }}
- uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
with:
workspaces: 'web/src-tauri -> target'
@@ -106,5 +109,42 @@ jobs:
Compiled from commit `${{ github.sha }}`.
releaseDraft: true
prerelease: false
includeUpdaterJson: true
uploadUpdaterJson: true
args: ${{ matrix.args }}
# tauri-action v1 writes each artefact's API URL into latest.json
# (api.github.com/repos/<repo>/releases/assets/<id>), and has no setting to
# change that. /api/updates/desktop (worker/routes/updates.ts) accepts only
# this release's download URLs and answers 204 - "no update" - to anything
# else, so desktop-v2.2.1, the first release built with v1, was offered to
# no installed app until its latest.json was fixed by hand. Once every
# platform has added its entries, scripts/updater_json.py rewrites them; it
# refuses an entry whose signature is not its file's .sig.
updater-json:
needs: build
permissions:
contents: write
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
# updater_json.py is stdlib-only, but it runs on the pipeline's Python
# like every other script, not on whatever the runner image ships.
- uses: actions/setup-python@v6
with:
python-version: '3.15'
- name: Point latest.json at the release downloads
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
TAG: ${{ github.event.inputs.tag || github.ref_name }}
run: |
set -euo pipefail
work="$RUNNER_TEMP/updater-json"
mkdir -p "$work"
gh release download "$TAG" --repo "$GITHUB_REPOSITORY" --dir "$work" \
--pattern latest.json --pattern '*.sig'
gh release view "$TAG" --repo "$GITHUB_REPOSITORY" --json assets \
--jq '[.assets[] | {id: (.apiUrl | split("/") | last), name}]' > "$work/assets.json"
(cd "$work" && python3 "$GITHUB_WORKSPACE/scripts/updater_json.py" "$TAG")
gh release upload "$TAG" "$work/latest.json" --repo "$GITHUB_REPOSITORY" --clobber
+11 -4
View File
@@ -4,15 +4,22 @@ on:
workflow_dispatch:
permissions: {contents: write}
# Shares the data-write group with every other workflow that commits to
# data/ — without it this can push mid-run against a 2-hour job.
# data/ — without it this can push mid-run against a long job. queue: max -
# a run that finds another data job running waits its turn (first in, first
# out) instead of evicting the run already waiting.
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
snapshot:
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with: {python-version: '3.12'}
# main as it is when the job STARTS, so the snapshot holds what the
# jobs before it committed.
- uses: actions/checkout@v6
with: {ref: main}
- uses: actions/setup-python@v6
with: {python-version: '3.15'}
- run: chmod +x ./bash/snapshot.sh && ./bash/snapshot.sh
+106
View File
@@ -0,0 +1,106 @@
name: SonarCloud
# CI-based analysis, which replaced SonarCloud's automatic analysis: the two
# cannot both be on, and the scan fails while automatic analysis is enabled in
# the project's Administration > Analysis Method. What is code, what is test
# and what is not analysed at all is sonar-project.properties at the root.
# SonarCloud's GitHub App still posts the "SonarCloud Code Analysis" check on
# the pull request; this job runs both test suites for their coverage and
# uploads the analysis.
on:
push:
branches: [main]
# What the data jobs commit, all of it outside the analysis scope: a
# commit that touches nothing else has nothing new to analyse.
paths-ignore: ['data/**', 'games/**', 'scripts/*.jsonl', 'scripts/*.log']
pull_request:
types: [opened, synchronize, reopened]
paths-ignore: ['data/**', 'games/**', 'scripts/*.jsonl', 'scripts/*.log']
workflow_dispatch:
permissions: {}
concurrency:
# SonarCloud refuses an analysis older than the last one it has for a
# branch, so main's runs queue rather than overlap.
group: sonarcloud-${{ github.ref }}
cancel-in-progress: ${{ github.event_name == 'pull_request' }}
jobs:
# Pull requests from forks and from Dependabot get no repository secrets.
# Without the token the scan cannot upload anything, so the scan job is
# skipped rather than failing every such pull request.
token:
runs-on: ubuntu-latest
outputs:
present: ${{ steps.check.outputs.present }}
steps:
- name: Check for the token
id: check
env:
HAS_TOKEN: ${{ secrets.SONAR_TOKEN != '' }}
run: |
echo "present=$HAS_TOKEN" >> "$GITHUB_OUTPUT"
if [ "$HAS_TOKEN" != "true" ]; then
echo "::notice::SONAR_TOKEN is not available to this run; skipping the SonarCloud scan."
fi
scan:
needs: token
if: needs.token.outputs.present == 'true'
runs-on: ubuntu-latest
timeout-minutes: 20
permissions:
contents: read
steps:
# Full history: SonarCloud blames every line to tell new code from old.
- uses: actions/checkout@v6
with:
fetch-depth: 0
persist-credentials: false
# Python coverage: coverage.xml at the root (pyproject.toml's
# [tool.coverage.run] says what is measured). The pipeline's install line
# and then the test tools, each in its own pip call, as python-tests.yml.
- uses: actions/setup-python@v6
with:
python-version: '3.15'
- name: Install the pipeline and the test tools
run: |
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
pip install --quiet --require-hashes --only-binary :all: -r requirements-test.txt
- name: pytest with coverage
run: python -m pytest scripts/tests -q --cov --cov-report=xml
# TypeScript coverage: web/coverage/lcov.info (vite.config.ts's
# test.coverage). build:admin runs `svelte-kit sync` - web/tsconfig.json
# extends the tsconfig it generates, and without it the analyser logs
# "Failed to parse tsconfig" and reads web/src with no types - and writes
# the admin bundle worker/index.ts imports, which the Worker's tests load.
# node_modules, .svelte-kit and the bundle are gitignored, so none of
# them is analysed itself.
- uses: actions/setup-node@v7
with:
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
# --ignore-scripts, as everywhere this repo runs `npm ci` (web-ci.yml
# says why).
- name: Install web/
working-directory: web
run: npm ci --ignore-scripts
- name: vitest with coverage
working-directory: web
run: |
npm run build:admin
npm run test:coverage
- name: SonarCloud scan
uses: SonarSource/sonarqube-scan-action@59202af334b4ba7b5db01b701b8e79f8b3bef0f4 # v8.5.0
env:
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+16 -4
View File
@@ -5,15 +5,27 @@ on:
schedule: [{cron: '0 5 1,15 * *'}]
workflow_dispatch:
permissions: {contents: write}
# queue: max - a run that finds another data job running waits its turn
# (first in, first out) instead of evicting the run already waiting.
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
leaderboard:
runs-on: ubuntu-latest
# About 0.55 s a game through the keyed Web API: ~65 minutes for 7,000
# offline games, ~2 hours at 14,000. The budget stops the sampling with
# time left to save and commit.
timeout-minutes: 240
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with: {python-version: '3.12'}
# main as it is when the job STARTS: a run that waited its turn must
# work on what the job before it committed.
- uses: actions/checkout@v6
with: {ref: main}
- uses: actions/setup-python@v6
with: {python-version: '3.15'}
- run: chmod +x ./bash/offline.sh && ./bash/offline.sh
env: {STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'}
env:
STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'
JOB_BUDGET_MINUTES: '200'
+16 -4
View File
@@ -3,15 +3,27 @@ on:
schedule: [{cron: '0 3 * * 0,3,5'}]
workflow_dispatch:
permissions: {contents: write}
# queue: max - a run that finds another data job running waits its turn
# (first in, first out) instead of evicting the run already waiting.
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
leaderboard:
runs-on: ubuntu-latest
# The player counts come from the keyed Web API with no pause between
# batches, about 0.55 s a game: ~27 minutes for 2,900 online games. The
# budget stops the sampling with time left to save and commit.
timeout-minutes: 150
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with: {python-version: '3.12'}
# main as it is when the job STARTS: a run that waited its turn must
# work on what the job before it committed.
- uses: actions/checkout@v6
with: {ref: main}
- uses: actions/setup-python@v6
with: {python-version: '3.15'}
- run: chmod +x ./bash/online.sh && ./bash/online.sh
env: {STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'}
env:
STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'
JOB_BUDGET_MINUTES: '120'
+13 -2
View File
@@ -3,15 +3,26 @@ on:
schedule: [{cron: '0 0 * * *'}]
workflow_dispatch:
permissions: {contents: write}
# queue: max - a run that finds another data job running waits its turn
# (first in, first out) instead of evicting the run already waiting.
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
update:
runs-on: ubuntu-latest
timeout-minutes: 90
steps:
# main as it is when the job STARTS. The commit the scheduled run was
# created on is older whenever another data job ran first, and this one
# then failed on a conflict in data/index.json (four times in ten days,
# October 2026).
- uses: actions/checkout@v6
with: {ref: main}
- uses: actions/setup-python@v6
with: {python-version: '3.12'}
with: {python-version: '3.15'}
- run: chmod +x ./bash/json.sh && ./bash/json.sh
env: {STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'}
env:
STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'
JOB_BUDGET_MINUTES: '60'
+23 -2
View File
@@ -1,19 +1,40 @@
name : Update Reviews
# Every game's review summary from IStoreBrowseService/GetItems, fifty games a
# request: about two minutes for the whole catalogue (scripts/update_reviews.py
# has the rules). It used to ask appreviews about one game at a time and, at
# 9,800 games, ran into GitHub's six-hour limit with nothing saved.
on :
schedule : [ { cron : '0 6 */2 * *' } ]
schedule : [ { cron : '0 6 * * *' } ]
workflow_dispatch :
inputs :
dry_run :
description : 'Dry run: read Steam, write nothing'
type : boolean
default : false
permissions : { contents : write }
# queue: max - a run that finds another data job running waits its turn
# (first in, first out) instead of evicting the run already waiting.
concurrency :
group : data-write
cancel-in-progress : false
queue : max
jobs :
reviews :
runs-on : ubuntu-latest
timeout-minutes : 60
steps :
-
uses : actions/checkout@v6
# main as it is when the job STARTS: a run that waited its turn must
# work on what the job before it committed.
with : { ref : main }
-
uses : actions/setup-python@v6
with : { python-version : '3.12' }
with : { python-version : '3.15' }
-
run : chmod +x ./bash/reviews.sh && ./bash/reviews.sh
env :
JOB_BUDGET_MINUTES : '40'
REVIEWS_DRY_RUN : ${{ inputs.dry_run }}
+10 -6
View File
@@ -5,12 +5,16 @@ name: Web CI
# during the Cloudflare migration, nothing would validate the frontend at all.
# Cloudflare Workers Builds deploys the site; this workflow only *checks* it.
# Workflow and Sonar changes run it too: web/shared/pipeline.test.ts and
# web/shared/toolchain.test.ts read .github/workflows/ (the data-write group, the
# Node and Python pins) and sonar-project.properties, and a pull request that
# touches only those files is exactly the one that can break them.
on:
pull_request:
paths: ['web/**', '.github/workflows/web-ci.yml']
paths: ['web/**', '.github/workflows/**', 'sonar-project.properties']
push:
branches: [main]
paths: ['web/**', '.github/workflows/web-ci.yml']
paths: ['web/**', '.github/workflows/**', 'sonar-project.properties']
workflow_dispatch:
permissions:
@@ -27,11 +31,11 @@ jobs:
run:
working-directory: web
steps:
- uses: actions/checkout@v4
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
node-version: '24'
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
@@ -96,11 +100,11 @@ jobs:
run:
working-directory: web
steps:
- uses: actions/checkout@v4
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
node-version: '24'
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
+1 -2
View File
@@ -13,8 +13,6 @@ Thumbs.db
# scripts/mark_dead_games.py and explicitly staged by mark-dead-games.yml.
# It survives *.log today only because ignore rules do not apply to
# already-tracked files -- rename or recreate it and it silently vanishes.
# (scripts/dead_links.log is deliberately NOT excepted: bash/dead_links.sh
# runs `git add .`, and that log is local diagnostic output.)
!scripts/dead_games.log
*.tmp
*.temp
@@ -120,6 +118,7 @@ pip-delete-this-directory.txt
.coverage.*
htmlcov/
*.cover
coverage.xml
# Jupyter Notebook
.ipynb_checkpoints
+242
View File
@@ -0,0 +1,242 @@
# Accessibility
This file is about using this project with a keyboard, a screen reader, zoom,
high contrast or reduced motion, or with anything else that is not a mouse and
a default screen. It covers:
- the website, <https://free-steam-games.win/>;
- the desktop and Android apps, which are the same interface running in the
system's web view;
- the data as plain text: [`data/`](data/) (JSONL), the CSV/JSON export on the
Games page, and the Markdown leaderboards in [`games/`](games/).
It does not cover Steam's own pages, Cloudflare's Turnstile widget (the
website's human check) or GitHub itself. Those belong to Valve, Cloudflare and
GitHub.
One person maintains this as a hobby, and nobody has audited it. So this is not
a certificate. It is a list of what is known to work, what is known not to, and
how to say so when something gets in your way.
## The goal
**[WCAG 2.2](https://www.w3.org/TR/WCAG22/) Level AA** is the target. It is a
target, not a claim: the app has not been audited against it, and the
limitations below mean it does not meet it today.
What matters most, in this order:
1. Finding and opening a game (search, filters, the games list, a game's page)
with a keyboard, a screen reader or zoom.
2. Nothing said with colour alone, or only in a mouse-hover tooltip.
3. No traps, including the first-run screens every visitor has to get past.
4. The reader's own settings win: language, reduced motion, light or dark,
zoom.
## What works today
Checked against the code on 2026-11-09, for the website and the desktop and
Android apps 2.5.1.
- **Language.** The page declares its language, and changes it when you
switch between English and Vietnamese.
- **Structure.** "Skip to content" is the first thing the keyboard reaches.
The header and both navigation menus are labelled, and the menus mark the
page you are on. Each page has one main heading and its own title, and
moving to another page announces the new title.
- **Keyboard.** Links and controls show a focus ring.
<kbd>Ctrl</kbd>/<kbd>⌘</kbd>+<kbd>K</kbd> opens a command palette that
works like a search box with a list: arrow keys, <kbd>Enter</kbd>,
<kbd>Esc</kbd>. The menu drawer on small screens, the palette and the
desktop update dialog keep focus inside while they are open, close with
<kbd>Esc</kbd>, and put focus back where it was.
- **The games table.** A screen reader hears a table: column headers
(including names for the image, data-issue and Steam columns), the total
number of rows and columns, and the position of each row, even though only
the rows on screen exist. Each row is one stop for <kbd>Tab</kbd>, the
game's name, and the whole row lights up when it has focus. Clicking
anywhere on a row still opens the game. On a phone the cards are a list
that says how many games it holds and where you are in it.
- **The first-run screens.** The terms screen and the human check are
dialogs. Focus moves into them, and the page behind is out of reach for the
keyboard and for screen readers until you are through. The command palette
shortcut does nothing while they are open.
- **Names.** Buttons that only show an icon have a text name. Switches (the
language and theme buttons, the scrollbar options, the choices on *Random
games*, the anti-cheat families) say whether they are on.
- **Colour and contrast.** In both themes, text is at least 4.5:1 against its
background, badges and the current menu item included, and the edges of
text boxes and drop-downs are at least 3:1. Kernel-level anti-cheat carries
a shield icon as well as its red, and the words "Kernel-level". They are
spelled out on a game's page and read out by screen readers in the table,
the cards and *Random games*. A test computes these ratios from the theme's
colours, so a later colour change cannot quietly undo them.
- **Charts.** Each chart is announced as an image named by its title. Some
also give the numbers as text: *Top online* and *Top offline* list 100 games
under their charts, *Genres* lists the top 24, *Tags* writes out 40 of its
60 words with their counts, and the anti-cheat chart links to a real table
that also says, in words, which anti-cheat runs at kernel level.
- **Images, sound and motion.** Game art is decorative (`alt=""`); the game's
name is always written next to it. Nothing plays sound or video. With your
system's *reduce motion* setting on, page animations and transitions are cut
short, and scrolling jumps instead of gliding, "back to top" included.
- **Zoom and small screens.** The website never blocks pinch-zoom, and the
games list keeps a usable height at 400% zoom. The desktop app zooms with
<kbd>Ctrl</kbd>/<kbd>⌘</kbd> and <kbd>+</kbd> / <kbd>−</kbd>. Below tablet
width the games table turns into cards, and a test checks that every grid
falls back to one column on a phone.
- **Settings.** Theme (dark by default, light, or follow the system), English
or Vietnamese, and hidden scrollbars. Hidden scrollbars still scroll from
the keyboard.
- **Plain text.** Every game has its own page. The Games page exports what you
have filtered as CSV or JSON. The whole dataset is plain JSONL in
[`data/`](data/), and the two leaderboards are Markdown tables in
[`games/`](games/).
## Known limitations
Known, and not fixed yet. Where there is another way to get the same thing, it
says so.
- **Charts.** Values, tooltips and legends are drawn on a canvas and need a
pointer. Several charts have no text version: DRM, languages, platforms,
players, reviews, release years, delisted games, most of *Stats*, and the
genre chart on the dashboard. Several tell categories apart by colour alone.
Chart animations ignore *reduce motion*.
*Instead:* the CSV/JSON export, or the raw data.
- **The games table is virtualised.** Only the rows on screen exist in the
page. A screen reader is told the full count, but the browser's
find-in-page only sees those rows.
*Instead:* narrow the list with search and the filters, or export to
CSV/JSON.
- **The human check is Cloudflare Turnstile,** in a frame this project does
not control. If it says your browser is unsupported, there is no retry
button.
*Instead:* the desktop and Android apps never show it, and everything in
the catalogue is readable on GitHub.
- **Hover-only hints.** To sighted readers, the 💀 on a dead game and the
warning icon in a table row explain themselves only in a mouse-hover
tooltip. Screen readers get the words.
*Instead:* **Hide dead** on the Games page takes dead games out of the
list.
- **Changes that are not announced:** the number of results after you filter,
the page number, and loading or error messages. The pop-up notifications'
own labels ("Notifications", "Close toast") stay in English when the app is
in Vietnamese.
- **Text in another language is not marked as such.** The legal documents
exist only in English. Game names and descriptions are in whatever language
the developer wrote them. None of it is tagged, so a screen reader reads it
in the interface language's voice.
- **Contrast themes** (Windows' forced colours) get no special support.
- **Zoom.** Long values are cut off with "…", and a few small labels have
fixed pixel sizes. As far as the code shows, the Android app does not
pinch-zoom.
*Instead:* game pages and the CSV/JSON export, the website in a browser, or
your system's magnifier or text size.
- **Automated checks are static.** A test holds the fixes above in place and
computes the theme's contrast, but nothing runs a screen reader or an
accessibility scanner, and Svelte's accessibility warnings do not fail the
build.
## Supported environments
| Where | Runs on | Checked by hand |
| --- | --- | --- |
| Website | Any current browser | Chrome, Edge, Firefox and Brave on Windows 11; Safari, Chrome and Brave on iOS 26 (iPhone 14 Pro, iPhone 13 Pro Max) |
| Desktop app | WebView2 (Windows), WKWebView (macOS), WebKitGTK (Linux) | Windows 11. The macOS and Linux builds are not checked by hand. |
| Android app | Android System WebView, Android 11 or newer | Emulator (Android 11 to 16) and a vivo 1907 (Android 12) |
The apps get their accessibility from the system's web view. What a screen
reader can do in them is roughly what it can do in Edge on Windows, Safari on
macOS, or Chrome on Android. The full device list is in
[`docs/pc_spec.md`](docs/pc_spec.md).
**Assistive technology used so far:** the keyboard alone, and the Narrator and
NVDA screen readers on Windows. VoiceOver on a real iPhone 14 Pro (iOS 26),
in Safari, Chrome and Brave, with the interface in English and in Vietnamese:
passed (2026-11-09).
**Not tried yet:** JAWS, VoiceOver on macOS, TalkBack (Android), Orca
(Linux). Reports from any of them are especially welcome.
## Reporting a barrier
Open an issue with the
**[♿ Accessibility barrier](https://github.com/poli0981/free-steam-games-list/issues/new?template=accessibility.yml)**
form. You don't have to say anything about yourself or any disability: what
you were trying to do, and what got in the way, is enough. Screenshots and
recordings are welcome, but never required.
Rather not post in public, or no GitHub account? Email
**contact@poli0981.dev**.
What helps, if you have it:
- the page: its address, or its name in the app;
- what you tried to do, and what happened instead;
- the browser or app, and its version. The app version is shown as
"Steam · v…" under "F2P Tracker" in the sidebar, or in the menu on a small
screen;
- your operating system, and any assistive technology or setting involved
(screen reader, zoom level, high contrast, reduced motion);
- how much it gets in the way: you can't do it at all, it's hard or slow, or
it's just annoying.
A security problem is not an accessibility report: see
[`SECURITY.md`](SECURITY.md).
## What to expect
One person, as a hobby, in a timezone that is probably not yours. It's the same
deal as [`SECURITY.md`](SECURITY.md).
- A first reply usually within a week.
- Something that stops you using a part of the site or the apps comes first.
Then things that make it hard or slow, then the cosmetic ones.
- No fixed deadline for a fix. If there is a way around the problem, the reply
says so.
- Reports get the `accessibility` label. The issue stays open until the fix is
live: on the website as soon as it is merged, in the desktop and Android
apps with their next release.
- Credit in the [CHANGELOG](CHANGELOG.md) if you want it.
## For contributors
The same rules for people and for coding agents. For any change to the
interface:
- Use it with the keyboard alone. Everything should be reachable with
<kbd>Tab</kbd>, in a sensible order, with focus always visible and nothing
that traps it.
- Give every control a name a screen reader can read: a visible label, or an
`aria-label` on an icon button. Images get `alt`, empty (`alt=""`) when they
only decorate.
- Never say something with colour alone, or only in a hover tooltip.
- Check it 360 px wide, at 200% zoom, in both themes, and with *reduce motion*
on.
- Build overlays and pop-ups on Bits UI's `Dialog` (focus trap,
<kbd>Esc</kbd>, focus returned), not a hand-made `div`. A screen that must
block the page reports itself in `web/src/lib/overlays.svelte.ts`, and the
layout makes everything behind it inert.
- Put new text in both `web/src/i18n/locales/en.json` and `vi.json`.
- Read the accessibility warnings `npm run check` prints. CI does not fail on
them, so nobody else will. Add no new `svelte-ignore a11y_*` without giving
a reason in the pull request.
- `web/src/lib/a11y.test.ts` holds the fixes listed above and the theme's
contrast. If it fails, fix the change, not the test.
The [pull request template](.github/pull_request_template.md) has the short
version as a checklist. Coding agents also follow [`CLAUDE.md`](CLAUDE.md),
which says to keep this file true.
## Keeping this honest
- **Owner:** the maintainer, [@poli0981](https://github.com/poli0981).
- A change that fixes a limitation above, or adds one, updates this file in the
same pull request.
- This file is read through again whenever an app release changes the
interface.
- Ideas for the statement itself go to
[Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas),
or an issue.
*Last reviewed: 2026-11-09 (website and apps 2.5.1).*
+8 -5
View File
@@ -17,8 +17,11 @@ This file lives at the repo root so the author can be found without digging into
| Everything else | <https://poli0981.dev/links/> |
`poli0981.dev/links/` is the single source of truth for every other channel
— chat, socials, video, donations. It is maintained there rather than in
— chat, socials, video. It is maintained there rather than in
this repository so a moved or retired account cannot leave a dead link here.
Donation links are the exception: they live in
[`.github/FUNDING.yml`](.github/FUNDING.yml) and on the web app's
[Donate page](https://free-steam-games.win/donate).
Anything that should not be public belongs in email — `contact@` unless one of
the role addresses fits better. Security reports go to GitHub's private
@@ -32,23 +35,23 @@ For people forking the repo or trying to reproduce a build:
| --------------- | ------------------------------------------------------------ |
| GitHub | [@poli0981](https://github.com/poli0981) |
| IDE | JetBrains 2026.x — paid lineup (PyCharm, WebStorm, RustRover) |
| Toolchains | Python 3.12 · Node.js ≥ 22 · Rust stable · Tauri 2 |
| Toolchains | Python 3.15 · Node.js 26 · TypeScript 7 + 6 · Rust stable · Tauri 2 |
| Git | GPG signing on (`commit.gpgsign=true`) |
| Hardware spec | [`docs/pc_spec.md`](docs/pc_spec.md) (EN) · [`docs/i18n/vi/pc_spec.md`](docs/i18n/vi/pc_spec.md) (VI) |
| Dev environment | [`docs/dev_env.md`](docs/dev_env.md) (EN) · [`docs/i18n/vi/dev_env.md`](docs/i18n/vi/dev_env.md) (VI) |
| Desktop build | [`web/src-tauri/TAURI.md`](web/src-tauri/TAURI.md) |
| Test devices | iPhone 14 Pro · iPhone 13 Pro Max · iOS 26.x (Chrome / Brave / Safari) |
| Test devices | Windows 11 (Chrome / Edge / Firefox / Brave) · iPhone 14 Pro and 13 Pro Max, iOS 26.x (Safari / Chrome / Brave) · Android 11–16 emulator + vivo 1907 (Android 12) — full list in [`docs/pc_spec.md`](docs/pc_spec.md) |
## Contributors
Anyone who's filed an issue, opened a PR, or used the Add-Games template is implicitly thanked. The full list is whatever GitHub renders on the [contributors page](https://github.com/poli0981/free-steam-games-list/graphs/contributors).
Anyone who's filed an issue, opened a PR, or suggested a game in Discussions is implicitly thanked. The full list is whatever GitHub renders on the [contributors page](https://github.com/poli0981/free-steam-games-list/graphs/contributors).
## AI assistants (full disclosure)
About **~70 %** of the code in this repository was generated with help from large-language-model assistants:
- **Grok (xAI)** — initial v1 Python pipeline (~2025).
- **Claude (Anthropic)** — v2 refactor, full data layer, the React/Vite web app, the Tauri 2 desktop wrapper, the GPG-signing path, the legal docs, and most recent commits.
- **Claude (Anthropic)** — v2 refactor, full data layer, the web app (React/Vite first, SvelteKit since v4), the Cloudflare Worker and `/admin`, the Tauri 2 desktop and Android apps, the legal docs, and most recent commits.
Generated code is reviewed and tested before each commit. No user data is sent to any LLM at runtime — LLM calls happen on the maintainer's dev machine, never from your browser.
+61 -1609
View File
File diff suppressed because it is too large. Load diff
+499 -51
View File
@@ -11,11 +11,48 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
**Git is the source of truth for game data.** Nothing else is. Keep it that way.
## Project status: stable, maintenance only (since 2026-11-11)
The project is finished, not abandoned. The pipeline, the site and the apps
keep running; the code no longer grows. What that means for any change:
- **No new features**, and no refactor or redesign for its own sake. A
request for one is declined, whoever asks in an issue or a pull request.
- **Code changes only for** a security advisory (CVE, CodeQL, RustSec,
`npm audit`), a runtime or dependency update (Node, Python, Rust, npm / pip
/ cargo packages, pinned Actions), and whatever those break. A bug or an
accessibility barrier gets the smallest fix that closes it.
- **Issues and pull requests from others are for the data**: add a game
(`scripts/temp_info.jsonl`), correct one (`data/overrides/`), remove one
(`data/blocklist.jsonl`). The issue forms are `add_game`, `edit_game`,
`delete_game`, `bug_report` and `accessibility`; blank issues are off
(`.github/ISSUE_TEMPLATE/config.yml`). The About page links those five by
file name, so renaming a form is a web change.
- The policy is stated in `README.md` ("Project status"), `CONTRIBUTING.md`,
`SECURITY.md` and the pull-request template: change them together.
- **Release notes are one file per release**:
`changelog/v<major>/<major>.<minor>.x/<version>.md`, and `changelog/beta/`
for a pre-release (none so far). `CHANGELOG.md` is the index, and keeps
`## [Unreleased]`, where every change writes its entry. A release moves that
section into its new file (headings one level up, relative links prefixed
`../../../`), adds its row to its major's table and empties [Unreleased];
what the file says below its title and back link is the GitHub release's
notes. A released file is not reworded afterwards.
- Every rule below still holds. Maintenance mode is when they matter most:
the next change will be made by someone who has not touched the code for
months.
## Data invariants — get these wrong and you corrupt the dataset
- **`appid` is not a stored field.** It is parsed out of `link` with
`/\/app\/(\d+)/` (`web/src/lib/data-store.ts`, `extract_appid` in
`scripts/core/data_store.py`). Never add it as a column; derive it.
`scripts/core/data_store.py`). Never add it as a column; derive it. It is
ASCII digits on both sides: JavaScript's `\d` is ASCII, Python's is not, so
`extract_appid` refuses a run of digits with any non-ASCII one in it
(`/app/730٤` is `None`, never 730) and `normalize_link()` reads a queued line
through NFKC first, which turns a Japanese keyboard's `5118700` into
5118700. A non-ASCII appid would miss every comparison and make
`rotation.slice_of()` (`.encode("ascii")`) stop every refresh.
- **Numeric-looking fields are formatted strings, not numbers.**
`current_players: "492,197"`, `reviews: "86% (Very Positive)"`,
@@ -67,6 +104,13 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
field an active override covers, or a retired entry's value, would be undone
by `apply_overrides()` and bump `last_updated` on every run.
One stored genre is not a judgement: a value in `NOT_GENRES` ("Free To
Play", "Early Access"; `constants.py`), a price model or a release state.
Until v4.6.0 the skip list matched appdetails' names case-sensitively and
1,357 games were stored with "Free To Play". `fetcher.pick_genre()` compares
casefolded and never falls back to one, and Refresh Store Data replaces a
stored one (`is_stray_genre()`) from appdetails, guarded like any writer.
- **`data/overrides/<appid>.json` is human intent, and it is permanent.**
`apply_overrides()` is called from inside `save_main()` — the single choke
point through which all 15 data-writing scripts pass, and the only code that
@@ -222,15 +266,28 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
(tags, languages, `language_details`, `has_paid_dlc`) every 7 days,
appdetails (name, header image, description, developer/publisher, release
date, platforms, Metacritic, DRM notes) every 30. Never `appid % cycle`:
appids are mostly multiples of 10, which leaves most slices empty. It
appids are mostly multiples of 10, which leaves most slices empty. A cycle
grows with the catalogue instead of the run (`rotation.cycle_for()`: past
`PAGE_DAILY` 2,000 pages or `DETAILS_DAILY` 500 appdetails a day it becomes
14, 21, ... or 60, 90, ...) and is always a MULTIPLE of its base, so a game
keeps its weekday and its day of the month and visits only ever thin out.
The slice is visited in `rotation.daily_order()`, so a run that meets its
time budget leaves a different tail each day. It
replaces values only with NON-EMPTY ones, never writes `MANUAL_FIELDS` or
`notes`, trusts `has_paid_dlc` only from a real store page (an age gate has
`notes` - except a stray genre (above), read from appdetails every day,
first after the page repairs, at most `GENRE_DAILY_CAP` a day, and left
alone under an override - trusts `has_paid_dlc` only from a real store page (an age gate has
no language table or tags) or a gated game's DLC prices, compares every
value as stored (normalised, `description` truncated - and a blurb merely
cut off later, now that `&quot;` is one character, is written without
counting as news), and bumps `last_updated` only on a real change. A game
cut off somewhere else is written without counting as news: later, now
that `&quot;` is one character, or earlier, at a CJK sentence end since
v4.6.0; `_fuller_cut()` takes two cuts of one text, never a rewrite), and
bumps `last_updated` only on a real change. A game
with empty tags, languages or `language_details` is in the page group EVERY
day, first, capped at `MISSING_DAILY_CAP`; `--missing-only` runs just those.
A game whose appdetails no longer call it free is LISTED in a `::warning::`,
never written: purge removes a game only when the store API flags it too,
and this is where the opposite case shows.
A new field added to it must obey the same rules;
`scripts/tests/test_refresh_store_data.py` holds them.
- **A store page behind Steam's age gate is never parsed.** An 'Adult Only'
@@ -252,7 +309,8 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
with `l=english`: without it, a runner was once answered in Russian.
- **`all_time_peak` only ever goes UP, and `refresh_peaks.py` is what raises
it** (daily 19:30 UTC, "Refresh All-Time Peaks"). A `crc32(appid) % 30`
slice (`core/rotation.py`, shared with `refresh_store_data.py`) reads
slice (`core/rotation.py`, shared with `refresh_store_data.py`; 60, 90, ...
past `PEAK_DAILY` 400 pages a day, never shorter) reads
SteamCharts' recorded all-time peak - the only source older than our own
sampling: SteamDB forbids scraping and Valve's APIs know only today. Every
run also raises it from our samples (`peak_today`, which despite its name is
@@ -260,8 +318,9 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
`apply_players()` raises it on every sample, never from a 0. SteamCharts has
no API, terms or robots.txt, so: one page per game a month, 2-3 s apart, a
User-Agent that names the project; 500 is an app it does not track (most of
the long tail), 404 one it has never seen; a 403, 429 or challenge page
stops the run with a warning, not a failure. `refetch_all.py` must never
the long tail), 404 one it has never seen; a 403, 429 or challenge page,
or the job's time budget, stops the run with a warning, not a failure.
`refetch_all.py` must never
clear the field - it cannot be fetched again - and nothing may lower it.
The backfill is a manual run with `backfill` ticked (~4 h, start it in the
evening UTC). DISCLAIMER section 6 names the source, so rewording it reopens
@@ -293,6 +352,47 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
name and the new key are the same family, and a known label stays as it was
written (so "Easy Anti-Cheat" and "EAC" both occur; the site groups them).
`scripts/tests/test_anticheat.py` and `test_refresh_anticheat.py` hold it.
- **Reviews are Steam's own summary, read for EVERY game daily**
(`update_reviews.py`, "Update Reviews" 06:00): `GetItems` with
`include_reviews`, fifty games a request (`SteamClient.fetch_items()`, the
sweep the anti-cheat and purge jobs share), ~2 minutes. It asked
`appreviews` one game at a time until v4.4.0 and, at 9,800 games, ran into
GitHub's six-hour limit with nothing saved. Rules: the percentage is Steam's,
FLOORED (`reviews_from_summary()` floors appreviews in integers too, so an
ingest and the refresh agree; until v4.4.0 it was rounded, one point higher
on ~40% of games); a GetItems count of 0 never replaces a percentage - its
summary has said 0 for a game with thousands (845070) - so such a game is
asked on appreviews (`ASK_CAP` 300 a run, daily order) and keeps its value
when that gives no answer; "N/A" (never read) with a count of 0 becomes
"No reviews"; no item, no usable summary or a failed batch keeps the value.
**appreviews has answered with a 302 to the store front since 2026-10-23**
(from here and from GitHub's runners; it worked on 10-17), so `fetch_full()`
falls back to the same GetItems summary (`reviews_from_store_api()`) and an
ingest no longer leaves "N/A". A record's `last_updated` moves on a change
and on a HEARTBEAT: a
game read whose stamp is 14-20 days old (crc32 jitter) is stamped again.
The site calls a record older than 30 days stale (`web/src/lib/validation.ts`,
`/health`), and this job used to stamp every game on every run; the
heartbeat keeps "the pipeline confirmed this lately" true without rewriting
every record daily. `scripts/tests/test_update_reviews.py` holds it.
- **A game is purged only when two of Steam's answers agree**
(`purge_unhealthy.py`, "Purge Unhealthy Games" daily 07:00). GetItems
screens the whole catalogue (`store_items.screen_item()`: unknown to Steam,
`visible` false, `unlisted`, `release.is_coming_soon`, no `is_free`; never
`type` - a free mod is listed on purpose), and `check_game_health()`
(appdetails) must confirm each flag. An `unavailable`/404 answer is asked
again `RECHECK_AFTER` (5 min) later: appdetails answered `success:false` for
14 live games in two bursts on 2026-09-27. A failed batch or a network error
is never "gone"; blocklisted games are not asked about. More than 500 flags
or 100 confirmed removals exits non-zero BEFORE anything is written
(`--max-candidates`, `--max-removals` to override). Removals are logged to
`removed_games.jsonl` exactly as before - `reconcile.ts` reads them. A
`::notice::` names earlier removals GetItems now sees free, listed and
released (re-queue the link to bring one back: a purged game keeps its D1
decision and discovery never proposes it again). Check Dead Links is gone:
HEAD on a delisted app's page ends on the store front with 200, so in its
whole life it never found a dead link, and it took 5.5 hours.
`scripts/tests/test_purge_unhealthy.py` holds it.
- `ingest_new.py` only reads `scripts/temp_info.jsonl`, and a line is a store
LINK and nothing else: every other key is ignored and the game is built from
Steam (`merge_extension_data()` went with the archived browser extension;
@@ -305,20 +405,47 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
appdetails calls other than `type: "game"` (`status_code: not_a_game` in
`removed_games.jsonl`) - the check that makes auto-approve safe, and why a
queued link cannot add a free DLC, demo or tool. The check lives in ingest
only: in `health_checker` it would make Purge delete old records every week.
only: in `health_checker` it would make Purge delete old records every day.
- **`ingest-new.yml` is also the removal job.** `bash/ingest.sh` runs
`remove_games.py` (applies `data/blocklist.jsonl`) and then
`ingest_new.py`, and commits once ("Apply removals" when `temp_info` did not
change). A separate removal workflow would keep evicting the ingest from
`data-write`'s single pending slot, and the ingest it. The workflow checks
out `ref: main`, not the triggering SHA: a run that waited its turn would
otherwise work on the data as it was when it was queued.
change), so one commit to either file starts one run that settles both.
The workflow checks out `ref: main`, not the triggering SHA, like every
data-write workflow: a run that waited its turn would otherwise work on the
data as it was when it was queued. It has no time budget: `clear_temp()`
empties the whole queue file, so a game it had not reached would be lost.
- New games ARE discovered automatically now, by `scripts/discover_new.py`
into the D1 review queue — but discovery only PROPOSES. Publication is
decided in `/admin`: by a reviewer, batch by batch, or by the auto-approve
rule a reviewer turned on there (off by default, at most 500 a day). Either
way it is a REQUEST in `temp_info.jsonl` that `ingest_new.py` still checks
game by game.
- **Discovery takes games in every language** (since v4.6.0). The store search
(`SteamClient.fetch_search_page()`) sends no `supportedlang`; pinned to
english it left out 1,592 of 18,790 free games (2026-10-30), mostly Chinese,
Japanese or Korean only, and without it Steam filters on no language at all.
Rules that are easy to break:
- The search sends `l=english`. It fixes the language of the row TEXT, never
which rows come back: discovery skips a row whose release reads "Coming
soon" and the backfill parses English month names.
- Every other request still asks Steam in English, so tags, genre, language
names, review labels and dates stay English; a name or description the
developer never wrote in English stays in their script. That is the
record, not a parsing error.
- A candidate's payload carries `languages` (appdetails'
`supported_languages`, read by `appdetails_languages()`), which `/admin`
shows with a "No English" badge. Auto-approve treats such a game like any
other. Rows queued earlier have no list: the Worker never rewrites a
queued row's `payload_json`.
- Both workflows' guard step greps the two discovery scripts for
`save_main|save_jsonl|clear_temp|fetch_full` as WORDS, comments and
docstrings included: none of the four may appear in them at all.
- The `discovery` group queues (`queue: max`) in both of its workflows, so
backfill windows dispatched together wait in turn instead of cancelling
each other; `pipeline.test.ts` holds a group to one setting.
- A game that declares no language (29 of them) has empty `languages` once
ingested: Refresh Store Data's repair group takes it every day and the
admin Quality page flags it. Accepted.
- **Auto-approve (`worker/lib/auto-approve.ts`, run by the cron after
reconcile) commits a batch only when every gate says yes**, and a gate it
cannot evaluate says no: enabled (or "Run one batch now"), its D1 lease,
@@ -329,8 +456,10 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
page previews is the SQL that runs). The empty-file gate is checked again
inside the commit (`requireEmptyQueue`), so a batch never lands mid-ingest;
"no row is approved" would have stalled it for the 12 hours a skipped row
stays approved. The idle gate exists because a push while a data job waits
EVICTS that job. `shared/pipeline.ts` lists every `data-write` workflow by
stays approved. The idle gate dates from when a push while a data job waited
EVICTED that job; with `queue: max` the ingest would only queue behind it,
and the gate stays so a batch lands when its ingest can start at once.
`shared/pipeline.ts` lists every `data-write` workflow by
file, and `pipeline.test.ts` fails when a workflow joins the group without
joining the list. Settings, limits and their validation are
`shared/automation.ts`, imported by the Worker and the page. A scheduled
@@ -389,20 +518,73 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
it must keep excluding). `geo.ts` FAILS OPEN on an unknown country:
`request.cf` is undefined under Vitest and under `wrangler dev` without
`--remote`, and failing closed there 403s every test.
- **Rate limiting has two layers, and the WAF rule is the first.** The zone's
one Free-plan rate-limiting rule (IP, 10 s, Block 10 s; `docs/SECURITY_SETUP.md`
§3a) refuses a burst before the Worker is invoked, and is the only limit on
the prerendered pages. `worker/lib/rate-limit.ts` is the second: the
`ratelimits` bindings in `wrangler.jsonc`, 60-second windows, one budget per
surface (`RL_DATA`, `RL_IMG`, `RL_API`, `RL_HUMAN`, `RL_ADMIN`), keyed by
IPv4 address or IPv6 /64, checked after the country block and before every
route and the Access check, answering 429 with `Retry-After: 60`. Rules:
- It FAILS OPEN (no binding, no `CF-Connecting-IP`, a throwing `limit()`).
Vitest and `admin/mock` bind no limiter, which is why no other test sees
it; the catalogue must never fail to load because of this layer.
- Counts are effectively PER SERVER, whatever the docs say about
"per location" (measured 2026-10-27, SIN): over one keep-alive connection
a budget held exactly (121 then 429), with a new connection per request
it refused nothing (175 human checks in 70 s against 20). So it stops
browsers and connection-reusing scripts; a client that reconnects every
time is the WAF rule's (which counted exactly 250). A limit is an abuse
ceiling far above any client (a cold catalogue load is ~16 data
requests), never a quota to tighten. Test it over ONE connection
(`SECURITY_SETUP.md` §3b), or it looks broken.
- Refusals are not logged: Workers Logs has the 429 status, and a line each
would double a flood's log volume.
- A 429 carries CORS only where its route does (`data`, `api`), never on the
human check or the admin surface.
- Every `period` stays 60 (the Retry-After), and a `namespace_id` is unique
in the ACCOUNT - another Worker reusing one shares its counters. A new
`run_worker_first` prefix needs a class, and a new binding needs its line in
`worker-configuration.d.ts`. `rate-limit.test.ts` holds the periods, the
namespaces, the binding names and the prefix coverage.
- `audit_log` and `commit_jobs` are pruned daily after `ADMIN_RETENTION_DAYS`
(wrangler.jsonc, 180). `docs/PRIVACY_POLICY.md` states the number: change
both together. `ingest_queue` and `ingest_decisions` are never pruned — the
decisions are what keep a rejected game out of the discovery sweep.
- Every workflow that writes to `data/` shares `concurrency: {group: data-write}`.
A new data-writing workflow without it will race jobs that run ~2 hours.
The group holds ONE pending run - a second queueing run cancels the first -
and scheduled runs here start 2-5 hours after their cron, so a new schedule
goes where nothing long is running (the long jobs - reviews, dead links,
purge - start mid-morning UTC and run 2-4 hours; Refresh Store Data is at
16:00 for that reason).
- **Every workflow that writes to `data/` shares `concurrency: {group:
data-write, cancel-in-progress: false, queue: max}`, checks out `ref: main`,
and declares `timeout-minutes`.** `pipeline.test.ts` fails on a data-write
workflow without any of them. A new data-writing workflow outside the group
would race the others.
- `queue: max` (GitHub, 2026-05-07) keeps up to 100 runs waiting, first in,
first out. The default keeps ONE: a run queueing behind a running job
cancelled the one already waiting - Update Reviews lost five of ten runs
that way in October 2026. Mixing the two settings in one group is
undocumented, so every member has `queue: max`.
- `ref: main`: a run's commit is fixed when the run is CREATED. A scheduled
run that waited behind another data job wrote shards from before that
job's commit, and `commit_push.sh`'s rebase then conflicted on
`data/index.json` - Auto Update JSON failed four days in ten that way.
- Scheduled runs start up to an hour after their cron (2-5 hours in
September). Waiting costs nothing now, but a long new job still goes where
nothing long runs (Refresh Store Data is at 16:00 for that reason).
- **Every long loop has a time budget** (`scripts/core/budget.py`). The
workflow sets `JOB_BUDGET_MINUTES` at least 20 below its `timeout-minutes`
(`pipeline.test.ts` checks); past it a loop starts no further game, the
script saves what it did and the job commits it, and a loop that used more
than three quarters says so in a `::warning::`. Loops visit their games in
`rotation.daily_order()`, so a cut falls elsewhere the next day. A job
stopped at its timeout commits nothing and concludes `cancelled`, which
`notify-ci-failure.yml` (a reusable workflow in `poli0981/.github`) does not
report: the budget is what keeps a growing catalogue from failing silently.
`process_batch(pause=False)` for the keyed Web API (player counts); the
15-30 s rest between batches stays for store pages and appdetails. Never a
budget for `ingest_new.py`. `refetch_all.py` runs in parts (`--part K/N`)
and clears each game on a copy that replaces it only once appdetails has
answered, so a cut part leaves every other game as it was.
- **Every data job commits through `bash/commit_push.sh`.** The group
serialises workflows, not `main`: a merged PR or an /admin commit can land
during a four-hour job, and a bare `git push` is then rejected and the run
during a long job, and a bare `git push` is then rejected and the run
thrown away (purge-unhealthy, 2026-09-21). The helper rebases onto
`origin/main` and retries; none of those writers touch the shards, so the
rebase is clean. A new wrapper must use it, once per commit (Refresh Store
@@ -427,13 +609,89 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
- `requirements.txt` pins every package the pipeline installs, transitive
ones included, with the sha256 of every file on PyPI, and every install
is `pip install --require-hashes --only-binary :all: -r requirements.txt`
(bash/*.sh and four workflows). Hash mode is all-or-nothing per pip call:
`requirements-test.txt` (pytest, hashed the same way) goes in its own call
in `python-tests.yml`, which runs the pipeline's line first so a
(bash/*.sh and the workflows that run Python). Hash mode is all-or-nothing
per pip call: `requirements-test.txt` (pytest and pytest-cov, hashed the
same way) goes in its own call in `python-tests.yml` and
`sonarcloud.yml`, which run the pipeline's line first so a
Dependabot bump is proven before a data job meets it, and
`requirements-dev.txt` (unhashed local tools) is installed on its own.
Adding a package means adding it and its dependencies with hashes:
`uv pip compile --universal --generate-hashes --python-version 3.12`.
`uv pip compile --universal --generate-hashes --python-version 3.15`.
- **One version of each runtime, and a test that holds them together**
(`web/shared/toolchain.test.ts`; web-ci also runs on `.github/workflows/**`
and `sonar-project.properties` so a pull request that only moves a pin meets
it). `docs/plan/16-toolchain-2026.md` has the upgrade notes.
- Node is the major in `web/.node-version` (26). Every `setup-node` repeats
it as a quoted literal, never `node-version-file`: `release-android.yml`
checks out the tag it rebuilds, and older tags have no such file.
`engines.node` and the `@types/node` major follow it. Workers Builds
reads the dashboard variable `NODE_VERSION=26`, the one copy the test
cannot see (`docs/DEPLOYMENT.md`): change it with the file.
- Python is the `python-version` of every `setup-python` (3.15), repeated
by `sonar.python.version` and the `--python-version` above. `codeql.yml`
alone stays on the newest Python CodeQL lists (3.14), named in the test's
`PYTHON_EXCEPTIONS`. A version is always quoted: YAML reads 3.10 as 3.1.
- Python 3.15 makes `open()` default to UTF-8 everywhere (PEP 686), but every
text open in `scripts/` still names `encoding="utf-8"`: on Windows an
older Python writes the locale's code page, and cp1252 cannot encode the
leaderboards' emoji.
- **SonarCloud analyses in CI (`sonarcloud.yml`), and its scope is
`sonar-project.properties`.** Automatic analysis is OFF in the project's
Administration > Analysis Method and must stay off: while it is on, every CI
scan fails. The scanner reads the file from the commit it analyses. Code and
tests both start at the root and are split by patterns: a new test-helper
folder goes into `sonar.test.inclusions` AND `sonar.exclusions`, or it is
analysed as code (and a file both include fails the scan). It leaves out the
dataset, generated Android resources and the SQLite migrations (the PL/SQL
analyser reads them as Oracle). `sonar.typescript.tsconfigPaths` names all
six tsconfigs in `web/` (auto-detection finds only files named exactly
`tsconfig.json`), and the job runs `npm ci --ignore-scripts` and
`npm run build:admin` (which syncs SvelteKit) first: `web/tsconfig.json`
extends the generated one, and without it the analyser logged "Failed to
parse tsconfig" and read `web/src` untyped. A new tsconfig joins that list.
The job skips commits that touch only what the data jobs write, and its
`scan` job is skipped when `SONAR_TOKEN` is not available (forks,
Dependabot).
**Coverage is measured there, not in the test workflows.** The job runs
pytest with `--cov` (`[tool.coverage.run]` in `pyproject.toml`: `scripts/`
without its tests, relative paths, `coverage.xml` at the root) and
`npm run test:coverage` (`test.coverage` in `web/vite.config.ts`: lcov with
`projectRoot: ".."`, so the paths start `web/`). Both reports are named in
`sonar-project.properties`; a path that does not resolve from the
repository root is silently uncovered. Coverage is off for a plain
`npm test`. The default "Sonar way" gate wants 80% on new code, and SonarCloud
counts every executable line a report does not name as uncovered: without
the reports `main` read 0.0% and failed it (2026-10-22). Suppressing a rule
for a file is done in the SonarCloud UI, not in this file or with NOSONAR.
- **Qodana analyses in CI too (`qodana.yml`), one Qodana Cloud project and
token per linter**: `qodana-python` over `scripts/` (`QODANA_TOKEN_PYTHON`),
`qodana-js` over `web/` (`QODANA_TOKEN_TS_JS`), `qodana-rust` over
`web/src-tauri/` (`QODANA_TOKEN_RUST`), the setup free-games-itchio-list
uses. Each project's settings are the `qodana.yaml` in its directory, with
a gate of zero problems (`failureConditions`): a new finding fails its job,
so fix it, or exclude the inspection there WITH its reason. All three need
an Ultimate licence (a trial in November 2026; the Rust linter is Early
Access): when it ends every job fails on it - renew, or delete
`qodana.yml` and the three `qodana.yaml`. What the first runs cost:
- Native `qodana-python` finds no interpreter by itself (`SDKs.json`
empty, then every `dict[int, str]` and `X | None` is an "invalid type
hint"): the job builds `.venv` and passes `QODANA_PYTHON_PATH`.
`scripts/` is the project directory because `core` resolves only there.
- The `qodana-rust` image has no C linker and none of Tauri's libraries,
and runs as the runner's user ("Analysis scope: 0 packages", a Critical
"Cargo project loading"): `-u root -e CARGO_HOME=/data/cache/cargo`, a
`bootstrap` that installs the packages, and a stand-in
`web/dist/index.html` so `generate_context!()` expands. It calls
`serde_json` unused; the expansion needs it (`::serde_json::Value`).
- `qodana-js` runs in Docker, not native: a `plugins:` entry (the Svelte
plugin, without which no `.svelte` file is read) fails to install in
native mode with every released CLI up to 2026.2.3 (QD-16701). With it,
every `@lucide/svelte/icons/*` import reads as unused, so
`ES6UnusedImports` is off (`noUnusedLocals` covers it).
- A subdirectory project needs `--project-dir <dir> --repository-root .`,
and each job its own cache keys (the default is one key per run). The
SARIF and logs are the `qodana-report-*` artifact, a zip inside the
artifact; `gh run view --log` is empty until the whole run has ended.
## Frontend gotchas
@@ -532,14 +790,83 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
- `echarts-wordcloud` declares a stale `echarts@^5` peer. It runs fine on
echarts 6 (all the legacy APIs it uses are still exported), so `package.json`
carries an `overrides` entry. Do not "fix" it by pinning echarts back to 5.
- **The `"@sveltejs/kit@2.70.3": { "cookie": "^0.7.2" }` override closes
GHSA-pxg6-pf52-xh8x** (kit 2 declares `cookie ^0.6.0`; only kit 3 moved on).
Kit imports just `parse`/`serialize`, which 0.7 keeps, and under
adapter-static that code runs only at prerender and in `vite dev`. The key
names kit's EXACT version because npm refuses a range key for a direct
dependency (`EOVERRIDE`). A kit bump therefore silently drops the override
and the alert comes back: re-key it, or delete it once kit asks for
`cookie` >= 0.7. Never carry it onto kit 3, which needs `cookie` 2.
- `runed` 0.35 (bits-ui's) declares an optional `@sveltejs/kit ^2.21.0` peer,
which npm enforces once kit is installed, so `package.json` overrides it to
our kit. bits-ui uses none of runed's kit code (`useSearchParams`, the only
part runed 0.38 changed for kit 3). Drop the entry once bits-ui depends on
runed >= 0.38.
- **SvelteKit 3 takes its options from its Vite plugin.** They are
`sveltekitConfig(tauri)` in `web/build/sveltekit-config.ts`, which
`vite.config.ts` passes as `sveltekit(sveltekitConfig(IS_TAURI))`;
`sveltekit-config.test.ts` holds both flavours. `svelte.config.js` is
refused (the build stops while the file exists), and what was `kit.*` there
is a top-level option (`adapter`, `csp`, `paths`, `prerender`). Rules that
are easy to break:
- **`$lib` is gone; `#lib/*` is package.json `imports`.** A module import
names `.js` even for a `.ts` file (`#lib/utils.js`), a component its
`.svelte`. `tsconfig.json` repeats the mapping in `paths`, because
`svelte-check --tsgo` redirects `.svelte` imports to the declarations it
emits only through `paths`: without it every `#lib` component fell back to
the `*.svelte` shim - props unchecked, no error.
- **`src/params.ts` is imported by Node itself** (`vite build` uses
`import()`, not Vite), so it and what it imports (`lib/legal.ts`,
`lib/schema.ts`) name real `.ts` files and stay type-strippable; a `.js`
or extensionless import there is ERR_MODULE_NOT_FOUND at build time.
- **The PWA is `build/pwa.ts`**: vite-plugin-pwa wired into kit 3's
`buildApp`. @vite-pwa/sveltekit never supported kit 3; it wrote the worker
when the SERVER build closed, which kit 3 does first. Ours writes it in a
default-order `buildApp` hook placed after `sveltekit()` - after kit's
build-and-prerender, before the adapter's `post` hook copies
`.svelte-kit/output/client` into `dist/`. Placed before `sveltekit()`, it
would glob an empty output.
- `goto` options are `replace` (not `replaceState`), `reset: false` (not
`noScroll`/`keepFocus`, which THROW in dev) and `refreshAll` (not
`invalidateAll`); `/games` writes its filters with `goto(url, {shallow:
true, replace: true})`. `goto` rejects a URL that matches no route.
- Hook types come from `@sveltejs/kit/hooks`. The client `handleError` gets
`{kind, error, event}` for every error and returns nothing to keep kit's
own status and message.
- `version.pollInterval` is kit's default (an hour), and kit also checks
`/_app/version.json` whenever the tab regains focus. A new version only
sets `updated.current`; a navigation that then fails reloads natively.
- **miniflare pins undici EXACTLY**, so an undici advisory in `npm audit`
waits for a wrangler whose miniflare pins the fixed version. undici runs
only in local tooling (`wrangler dev`, `cf:check`), never in the deployed
Worker. A bridging override (`"miniflare": { "undici": "^x" }`) goes in the
same commit that takes wrangler to such a release - left behind, it would
hold undici on its major after miniflare moves on. The one for
GHSA-xjj6-f33q-929c went with wrangler 4.156.0 (`npm ls undici`: 7.30.1,
miniflare's own pin).
- **The `"workbox-build": { "glob": "^14.0.2" }` and
`"filelist": { "minimatch": "^11.0.1" }` overrides close
GHSA-3g3m-2fjr-6pw4 and GHSA-g3hv-75wg-m249** (2026-10-30), fixed only in
the new majors. workbox-build 7.4.1 asks glob `^11` and calls only
`globSync(pattern, {cwd, follow, ignore})`, which glob 14 keeps; its one
break that could touch us, an `ignore` starting with `/`, matches nothing
in `vite.config.ts` or `build/pwa.ts`. The precache was compared URL by
URL before and after (172 = 172). filelist is reached only through ejs's
CLI (`ejs` → `jake` → `filelist`); the off-main-thread plugin calls
`ejs.render`, which never loads jake. Delete each override once
`npm ls glob minimatch` shows no version below the fixed one without it.
`deepmerge` (GHSA-gcqx-w48m-w2h4, low) has no fixed release at all; it
merges our own Vite/rollup config at build time, and its alert is
dismissed as tolerable risk.
- **TypeScript is two packages, on purpose.** TypeScript 7 (the Go compiler)
has no JavaScript API, and svelte-check and `svelte-kit sync` (route
`$types`) need one, so `typescript` stays 6 and 7 is the alias
`@typescript/native` (`npm:typescript@~7.0.x`). svelte-check `--tsgo` finds 7
by that name and runs its bin; the `tsc -p` steps call
`node node_modules/@typescript/native/bin/tsc` by path, because both
packages declare a `tsc` bin and `node_modules/.bin/tsc` is whichever one npm
linked last. `check:admin` stays on TypeScript 6: `--tsgo` cannot follow
`.svelte` imports from outside its tsconfig's folder (`web/admin` imports
`../src/lib/ui`), and a component it cannot map falls back to the ambient
`*.svelte` shim - unchecked props, and no error. Dependabot ignores
`typescript` majors and the alias (it mishandles `npm:` aliases): bump the
two by hand. `~7.0` because 7.1 changes the API svelte-check's experimental
mode uses. TypeScript 6 goes when svelte-check accepts 7 alone:
`docs/plan/17-typescript-7.1.md` lists the conditions, the steps and the
planted-error check that proves the switch.
- **Real paths everywhere, including the packaged apps.** There is no
HashRouter and no hash shim: `tauri::manager::get_asset()` falls back through
`<path>.html`, `<path>/index.html`, then `index.html`, so the Tauri webview
@@ -548,7 +875,11 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
HashRouter-era `/#/…` URLs still arrive - from released 1.4.x builds, and from
old links to the GitHub Pages site, whose tombstone redirect forwards the
fragment - and `upgradeLegacyHashUrl()` upgrades them on load with
`goto(…, {replaceState})`. Do not remove it, and do not reduce it to a
`goto(…, {replace: true})`; a path that matches no route (kit 3's `goto`
rejects it) goes to `/error/404`. The hash is resolved against the page's
origin and ignored if it names another (`#//other.example`), and nothing
from it may reach `location.*` - CodeQL flagged exactly that as XSS and an
open redirect. Do not remove it, and do not reduce it to a
`history.replaceState`: that fixed the address bar and left the dashboard
rendered.
- **`web/static/_headers` sets the browser cache, by path.** Hashed output
@@ -571,7 +902,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
must still trigger a build, or the site keeps the old text and hash; see
`docs/DEPLOYMENT.md` "Which commits deploy" for a configuration that does
both. Excludes beat includes there.
- **The CSP lives in `web/svelte.config.js` (`kit.csp`), not in `_headers`.**
- **The CSP lives in `web/build/sveltekit-config.ts` (`csp`), not in `_headers`.**
SvelteKit emits one inline bootstrap script per page and hashes it there. A
header CSP cannot coexist: browsers enforce the INTERSECTION of header and
meta policies, so a `script-src 'self'` header blocks the script whatever the
@@ -581,7 +912,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
- **That CSP has TWO flavours, chosen by `TAURI_ENV_PLATFORM`.** Under Tauri
the page origin is `tauri://localhost`, so `'self'` means the BUNDLE, not the
site — a `connect-src 'self'` policy blocks every `/api/data/*` fetch and the
packaged apps show an empty catalogue. `svelte.config.js` adds
packaged apps show an empty catalogue. `sveltekitConfig(true)` adds
`https://free-steam-games.win`, `https://api.github.com`, `ipc:` and
`http://ipc.localhost` only for that build; the web policy stays `'self'`,
because dropping `api.github.com` from it was deliberate (`/api/activity`
@@ -600,7 +931,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
the Tauri build with any of them.
- **Cloudflare Web Analytics must stay on "JS Snippet installation", never
automatic.** Automatic injection adds an INLINE loader at the edge, after our
response; `kit.csp` is `mode: "hash"`, and CSP3 makes a `script-src` carrying
response; the CSP is `mode: "hash"`, and CSP3 makes a `script-src` carrying
a hash ignore `'unsafe-inline'` — so no policy can ever admit it. It was
enabled that way for months, logging two CSP violations per page load and
collecting nothing. `lib/analytics.ts` appends the beacon itself, from the
@@ -641,7 +972,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
- **Never put `use:`, `onload` or `onerror` on an `<img>` that can be
prerendered.** Svelte then writes `onload="this.__e=event"` and
`onerror="this.__e=event"` into the HTML, to replay an event that fired
before hydration, and `kit.csp` is a hash policy, which refuses inline event
before hydration, and the CSP is a hash policy, which refuses inline event
handlers: one CSP violation per page view (the game hero logged it on every
page until it moved to an attachment). Use `{@attach}`, which writes nothing;
`lib/img-fallback.ts` recovers a load that already failed from
@@ -716,7 +1047,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
`lib/fallback-route.ts` recovers the route offline the same way it does
online. `verify-dist.mjs` now parses `dist/sw.js` and fails if the bound URL
is not a precache entry.
- **`kit.paths.relative` must stay `false`.** SvelteKit defaults it to `true`,
- **`paths.relative` must stay `false`.** SvelteKit defaults it to `true`,
which gives every PRERENDERED page `./_app/...` asset URLs. Served as the
fallback for `/games/730` those resolve to `/games/_app/...`, which misses,
falls into the SPA handler, and comes back as `index.html` with
@@ -740,8 +1071,9 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
`fallback-route.test.ts` holds the list against the routes whose `prerender`
is not literally `true`, and checks each one marks itself. A path that matches NO route hydrates the same
way with `page.route.id === null`; the root layout renders the 404 view in
place. Never `goto()` an unmatched URL — SvelteKit falls back to a native
load, the host answers with `index.html` again, and it loops forever.
place. Never `goto()` an unmatched URL: SvelteKit 3 rejects it (SvelteKit 2
fell back to a native load, the host answered with `index.html` again, and
it looped forever).
- **Game pages are prerendered from build-time seeds, through a UNIVERSAL load.**
`build/game-seeds.ts` serves `virtual:game-seeds`: in the SSR build it reads
`../data` and inlines a seed per game (slow-changing fields only — never
@@ -750,7 +1082,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
Do not turn it into `+page.server.ts`: client navigation would then fetch
`__data.json`, which for a game added after the deploy is `index.html` at
200, and the page errors. `__PRERENDER_GAMES__` is false for Tauri.
`kit.prerender.handleHttpError` ignores 404s under `/img/` and `/api/` only,
`prerender.handleHttpError` ignores 404s under `/img/` and `/api/` only,
because the crawler follows the page's `<img>` into a Worker route that does
not exist at build time. That handler only decides pass/fail; the
`[404] GET /img/…` line per game came from SvelteKit's DEFAULT server
@@ -777,7 +1109,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
`page.url.origin`, which during prerender is SvelteKit's internal
`http://sveltekit-prerender` host. `seo.test.ts` enforces both.
- **`sitemap.xml` is a prerendered route**, not a static file, driven by
`import.meta.glob` over the route table. It needs `kit.prerender.entries`
`import.meta.glob` over the route table. It needs `prerender.entries`
because nothing links to it. Extra exports from a `+server.ts` must be
`_`-prefixed or SvelteKit rejects the build.
- **`static/` art is generated.** `icon.svg` is the only hand-edited mark;
@@ -786,7 +1118,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
SVG.
- **The web app registers its service worker itself, after consent and the
human check.**
`@vite-pwa/sveltekit` cannot inject a registration script — SvelteKit has no
vite-plugin-pwa cannot inject a registration script — SvelteKit has no
`index.html` for it to write into — so for the whole of 2.0.0 the worker was
built and never registered, and the manifest was linked from no page.
`lib/pwa-state.svelte.ts` calls `registerSW` (`registerType: "prompt"`, so a
@@ -818,6 +1150,15 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
"no update" — for anything unusable. Like `/api/activity` it is public and
must never use the GitHub App token. A desktop release is offered only once
its draft is published.
tauri-action v1 writes API asset URLs (`api.github.com/repos/…/releases/assets/<id>`)
into `latest.json`, which that check refuses, and has no setting to change
it: the `updater-json` job of `release-desktop.yml` (`scripts/updater_json.py`)
rewrites them to the release's download URLs once every platform is built,
refusing any entry whose signature is not its file's `.sig`. Without it a
desktop release is offered to nobody (desktop-v2.2.1, the first v1 build,
needed a hand fix). Between the tag push and publishing the feed answers 204
anyway: the new tag is already in `releases.atom`, its `latest.json` not yet
public.
- **Legal consent is per-document content hashes, not one integer.**
`build/legal-versions.ts` serves `virtual:legal-versions` (a hash per
document, inlined) and `virtual:legal-sources` (the raw markdown, imported
@@ -837,24 +1178,129 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
The gate renders only after `consent.hydrated`: rendered before storage was
read, it was baked into every prerendered page and flashed for returning
visitors.
- **Declining or leaving at the gate.** In the apps Decline calls `exit()` from
`@tauri-apps/api/app` (capability `core:app:allow-exit` in
`capabilities/default.json`), never `getCurrentWindow().close()`: on Android
that resolves without closing anything (tao reports a destroyed window only
from the Activity's `onDestroy`), so Decline did nothing there before 2.5.0.
`exit()` finishes the activity on Android and ends the process on the
desktop; the declined notice appears if the app is still alive 2 s later. On
the web, "Leave site" (`lib/leave-site.ts`, hidden under Tauri) goes back to
the page before the site, because no page may open the browser's own start
page (`chrome://newtab`, `about:home`). Rules:
- It steps over ALL of the site's entries at once,
`history.go(-(navigation.currentEntry.index + 1))`: `entries()` is the
contiguous same-origin run, other documents and SvelteKit's pushState
entries included. Without the Navigation API it is one step back.
- `history.go()` is silent when there is nowhere to go (the foreign entries
can all be forward ones), so a 1.5 s watchdog shows "Nothing to go back
to"; `beforeunload`, `pagehide` and `popstate` cancel it. `pagehide`
matters: timers freeze in the back/forward cache and resume on restore.
- When every entry is the site's, closing the tab is a SECOND, explicit click
(`closeTab()`): closing the last tab closes the browser window with it.
- `consent-gate.test.ts` holds the exit import, the capability and the two
guarded Leave buttons; `leave-site.test.ts` holds the algorithm.
- **`/welcome` is shown once, by the layout, and only to a visit that STARTED
on `/`** (not a deep link, not `/#/…`, not mid-session), after consent and
the human check. It
uses `replaceState`, and the page marks itself seen on mount, so Back cannot
loop into it. Crawlers never consent, so `/` stays the indexable page.
- **`/legal/[doc=legaldoc]` has a param matcher** (`src/params/legaldoc.ts`).
- **`/legal/[doc=legaldoc]` has a param matcher** (`legaldoc` in `src/params.ts`).
An unknown slug therefore matches NO route and gets the layout's translated
404; without it the host's fallback (the prerendered dashboard) hydrated as
the doc route. Legal labels and hints in `lib/legal.ts` are i18n keys.
- **`/games` mirrors its filters into the query string, browser-only**:
`onMount` reads `location.search` (a link with filter parameters replaces the
stored filters) and a debounced `replaceState` writes back. Never read
stored filters) and a debounced shallow `goto` writes back. Never read
`url.search` in markup or a load - prerender throws on it. The page number
lives in the filter store, keyed to the criteria (`filters.pageFor`), so Back
from a game keeps the page and a changed filter starts again at page 1.
The language filter (`?lang=`) offers the names stored in `languages`,
Steam's English ones: data, never i18n keys.
- **`/random` keeps its picks in memory, and only the reader rolls.**
`lib/random.svelte.ts` holds appids, module-level so Back from a game shows
the same games, and NO `f2p:*` key: the Privacy Policy lists every stored
key, and editing it reopens the consent gate for everyone. Rules:
- A roll happens in a handler, or once in an `untrack`ed effect when the
catalogue first arrives - never in `$derived` or markup, which would roll
again on every revalidation or language switch. `resolve()` is the
deterministic part: it drops a pick that left the catalogue or stopped
qualifying, and nothing tops it back up.
- Randomness is `crypto.getRandomValues` with rejection sampling and a sparse
Fisher-Yates (`lib/random-pick.ts`). Never `Math.random`: SonarCloud
reports it as hotspot S2245, and an unreviewed hotspot fails the gate.
- Never a game marked unsafe or without an appid; dead games only on
request. The route is top-level on purpose: under `/games/` the header
search would stop jumping to /games, `isActive` would light Games too, and
the PWA's `globIgnores` would leave it out of the precache.
- A plural key needs its base key (`random.pool` beside `random.pool_one`):
`t()` falls back from `_other` to the base, and the i18n test requires
every literal key to exist.
- **Search folds; storage never does.** `lib/search-fold.ts` `fold()` is NFKC
plus hiragana to katakana, applied to BOTH sides of every search box
(`/games`' Fuse index, the palette, /developers, /publishers, the anti-cheat
list), so `トロイ`, `とろい` and `トロイ` find one game and a full-width `4`
or `:` its ASCII twin. Never apply it to stored text: NFKC rewrites U+3000
and half-width kana, which `save_main()` keeps as spelling. Rules:
- Fuse gets one `getFn` per KEY. A wrapped `Fuse.config.getFn` hands back
`{v, i}` objects for array fields (`tags`, `developer`, `publisher`), not
strings, and folding those type-checks and then breaks.
- Fold the query, THEN trim: NFKC turns U+3000 into a plain space.
- Not Fuse's `ignoreDiacritics`: it strips the dakuten, making ガ equal カ.
And no `includeMatches`: its positions would point into folded text.
- The header search jumps to /games only once an input method has finished
composing (`lib/layout/header-search.ts`); the value is still written on
every keystroke, because Android keyboards compose Latin words too. The
jump is `goto("/games", {reset: false})`: the default reset moved focus to
`<body>` and the next keystroke was lost. The page scrolls inside `<main>`,
which no reset touches, so focus is all `reset` changes there.
- The palette takes one kanji, kana or Hangul syllable where Latin needs two.
- A CSV download starts with a byte order mark (`csvForExcel()`), or Excel
opens CJK names as mojibake. It is the escape `"\uFEFF"` in the source;
the editing tools turn a typed escape into the raw character, so write it
with a script and check the bytes.
- **`safe` is classified by `lib/safety.ts`** (`y`, `n`, `?` = not reviewed,
`""` = never set). `/games`, `/stats` and `/health` all use it; `?` is a
to-do, not missing data, so /health reports it as its own group.
- **`ACCESSIBILITY.md` (root) is a claim about this code, like this file.**
Its "What works today" and "Known limitations" lists were checked against
the code on 2026-11-09. A change that fixes a limitation, or adds one,
edits the list and its "Last reviewed" line in the same pull request.
Reports arrive through `.github/ISSUE_TEMPLATE/accessibility.yml` (label
`accessibility`), and the About page links both the form and the statement.
`src/lib/a11y.test.ts` holds the fixes it lists. Rules that are easy to
break:
- **The games table is an ARIA table only when it is complete.** That means
`role="table"` with `aria-rowcount`/`aria-colcount`, a `rowgroup`, and
`aria-rowindex` on every virtualised row. Every column needs a label or an
`srLabel` (`games/columns.ts`). It used to be `<a role="row">` with
nothing around it, which a screen reader read as neither a table nor a
link.
- **A row is not a link.** The name's `<a>` stretches over the row
(`after:absolute after:inset-0`). Anything that must stay hoverable or
clickable on its own sits above it with `relative z-[1]`: the tooltips,
and the Steam `<a>`, which is `tabindex="-1"` so a row is one Tab stop.
The row draws the focus ring (`has-[:focus-visible]`), because cells clip
overflow.
- **The first-run overlays report to `lib/overlays.svelte.ts`.** The layout
makes the page behind them `inert`: the bare pages' wrapper, the skip link
and the shell. Ctrl/Cmd+K stands down while they are open, because the
palette would open under the gate and trap focus there. They are
`role="dialog"`, focus themselves with `focusOnMount`, and title
themselves with an h2. `BackToTop` is inside the shell so that it goes
inert with the page.
- **Kernel-level anti-cheat goes through `games/AntiCheatBadge.svelte`.** It
adds a shield icon and the words, so the colour is not the only cue.
- **Theme colours are checked by the WCAG formula.** The test computes
4.5:1 for text (badges on their /15 tint included) and 3:1 for
`--input`/`--ring` in both themes. A token edit that drops below either
fails.
- **Desktop zoom needs both parts:** `zoomHotkeysEnabled` on the window,
and `capabilities/zoom.json`. The latter is desktop-only, and macOS/Linux
zoom through an injected script that calls `set_webview_zoom`.
Svelte's a11y warnings never fail CI (`svelte-check` runs without
`--fail-on-warnings`), so read them.
## Admin SPA (`web/admin/`)
@@ -878,8 +1324,9 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
first: `worker/index.ts` imports the generated module, so a bare
`wrangler deploy` or `tsc` without it fails. That failure is intended.
`build:admin` runs `svelte-kit sync` first: the admin imports files under
`web/src`, whose `tsconfig.json` extends `.svelte-kit/tsconfig.json`, and on a
clean checkout (CI) that file does not exist until SvelteKit has synced. The
`web/src`, whose `tsconfig.json` extends `$app/tsconfig`
(`node_modules/$app/tsconfig.json`), and on a clean checkout (CI) that file
does not exist until SvelteKit has synced. The
emitter reads the bundle in `writeBundle`, never the output directory in
`closeBundle`, which also runs after a FAILED build and hid that error behind
an ENOENT.
@@ -901,7 +1348,8 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
- **It may import only pure modules of the public app**: `src/lib/ui/*`,
`src/lib/utils.ts`, `src/lib/prefs.svelte.ts`, `src/fonts.css`,
`src/styles/theme.css` (the design tokens, shared by both builds). Never
`$app/*` or `$lib/*`; that build cannot resolve them.
`$app/*` (nor a module that imports it) and no virtual module; that build
cannot resolve them.
- **`admin/mock/` is a dev server, not a mode.** `npm run dev:admin` runs the
real handlers against an in-memory D1 and fake GitHub; nothing under `worker/`
or `admin/src` may import it, and the Worker has no flag that skips
+2 -2
View File
@@ -8,12 +8,12 @@ Be nice. Or at least civil. We're all unemployed introverts at heart (or pretend
### Standards
- **Be respectful:** No harassment, no toxicity, no personal attacks. This ain't Dota 2 chat.
- **Be helpful:** Suggestions, additions, fixes – yes. Trolling, spam, off-topic rants – no.
- **Be inclusive:** Everyone's welcome, regardless of skill level (especially noobs on Easy mode).
- **Be inclusive:** Everyone's welcome, regardless of skill level (especially noobs on Easy mode), and however you use the site: mouse, keyboard, screen reader, zoom. If something keeps you out, see [`ACCESSIBILITY.md`](ACCESSIBILITY.md).
- **No malware/fake links:** Instant ban from contributing. I have trust issues already.
- **Disagreements?** Keep it calm in Issues/PRs. If it gets heated, I'll just close it and go play a game.
### Enforcement
I'm the only maintainer (with Grok as backup), so violations = close issue/PR, block if needed. No appeals – life's too short.
I'm the only maintainer (with an AI assistant as backup), so violations = close issue/PR, block if needed. No appeals – life's too short.
**Reporting:** if something needs raising privately rather than in the Issue
thread it happened in, email **contact@poli0981.dev**. One person reads it, so
+73 -31
View File
@@ -2,7 +2,28 @@
Yo, thanks for stopping by! This repo is a hobby project by a broke, unemployed Vietnamese dev (20-something, introvert max level, dropped out uni year 3, mooching off family, Steam library 400+ games 80% under $10 sale addiction). Powered ~70% by AI assistants — Grok for v1, Claude for v2+ — the only non-judgmental friends keeping this alive while I play Easy mode only :))
Want to help? Awesome — no strict rules, life's hard enough. Pick whichever path below is least-friction for you.
Want to help? Awesome — life's hard enough, so the rules are short.
## Project status: stable, maintenance only
Since 2026-11-11 the project is finished rather than abandoned. The pipeline
still refreshes the list every day and the site and apps stay up, but the code
is no longer growing:
- **No new features.** Feature requests are not taken, as issues, discussions
or pull requests. A pull request that adds one is closed, however good it is.
- **Code changes only for** security advisories (CVEs), runtime and dependency
updates (Node, Python, Rust, the npm / pip / cargo packages, the GitHub
Actions), and whatever those break. Dependabot opens most of them.
- **Issues and pull requests are for the data:** adding a game, correcting one,
removing one.
- Something **broken** (the site, an app, a wrong number) or an
**accessibility barrier** can still be reported. It gets a fix, not a
redesign.
- A **vulnerability** goes through [`SECURITY.md`](SECURITY.md), never a public
issue.
Forks are welcome to go further: the code is MIT and the dataset CC BY 4.0.
## Maintainer contact
@@ -27,50 +48,71 @@ reporting, see [`SECURITY.md`](SECURITY.md)), and <https://poli0981.dev/> or
## How to contribute
### 1. Open an issue (bugs, requests, removals)
### 1. Open an issue
Go to the [Issues tab](https://github.com/poli0981/free-steam-games-list/issues/new/choose) and pick a template:
Go to the [Issues tab](https://github.com/poli0981/free-steam-games-list/issues/new/choose) and pick a form:
- ➖ **Delete game** (max 10 per issue)
- 🐛 **Bug report**
- 💡 **Feature request / improvement**
- 📢 **Feedback / rant**
- ❓ **Off-topic**
- ➕ **Add game** — a free game that is still missing (max 10 per issue)
- ✏️ **Edit game** — a published game with something wrong: genre, type, anti-cheat, notes, safe
- ➖ **Delete game** — paid now, not a game, malware, duplicate (max 10 per issue)
- 🐛 **Bug report** — something that is broken
- ♿ **Accessibility barrier** — something you can't use with a keyboard, a screen reader or zoom (see [`ACCESSIBILITY.md`](ACCESSIBILITY.md))
Fill the form (checkboxes, dropdowns, short descriptions). Every template is reviewed by hand when caffeine hits — none of them auto-run a workflow.
Blank issues are off. Every form is reviewed by hand when caffeine hits — none of them auto-run a workflow.
> Issues are for **reports**, not game submissions. To suggest a game, see section 2.
New free games are found on Steam automatically every day and reviewed before they are listed, so most turn up on their own. Use **Add game** for one that is still missing a few days after it went free.
### 2. Open a pull request (data)
### 2. Suggest a game, or a correction
Fork → branch → one of these → push → open the PR. The template has a short checklist.
New free games are found on Steam automatically every day and reviewed before they are listed, so most turn up on their own. If one is still missing a few days after it went free, or a published game has something wrong (genre, anti-cheat, notes…), post it in [Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas) with the store link. A correction becomes an override that every pipeline run keeps.
**Add a game:** append store links to `scripts/temp_info.jsonl`.
```jsonl
{"link": "730"}
{"link": "https://store.steampowered.com/app/570/"}
```
A queued line is a link and nothing else (full URL, short URL or bare appid): any other key is ignored, and the game is fetched from Steam and checked (free, a game, reachable) before it is published.
**Correct a game:** add an override. It is a standing instruction in `data/overrides/<appid>.json` that every pipeline run keeps.
```bash
python scripts/edit_game.py 730 --show
python scripts/edit_game.py 730 --set genre="FPS" --reason "Steam's genre is too coarse"
```
Only the human-judged fields can be overridden: `genre`, `type_game`, `safe`, `notes`, `anti_cheat`, `anti_cheat_note`, `is_kernel_ac`. Everything else (name, tags, languages, reviews, players…) is whatever Steam says and is refreshed from Steam.
**Remove a game:** add a blocklist line. The reason and the note are public.
```bash
python scripts/delete_game.py 730 --reason not_free --note "paid since 2026-11"
```
Reasons: `not_free`, `not_a_game`, `duplicate`, `broken`, `inappropriate`, `other`.
Leave out `--apply` in both commands, and **never edit `data/data_*.jsonl` or `data/index.json` by hand**: the pipeline rewrites them on its next run and an edit there is lost (and breaks the hashes the apps check). `Check Overrides` validates an override or blocklist change on the pull request.
### 3. Pull requests that touch code
Only two kinds are merged now:
- a **security fix** — report it privately first ([`SECURITY.md`](SECURITY.md));
- a **runtime or dependency update**, or the repair of what one broke.
`npm run typecheck && npm test && npm run build && node scripts/verify-dist.mjs --web` must pass in `web/`, and `python -m pytest scripts/tests` for the pipeline. Dependencies are pinned and hashed; the rules are in [`CLAUDE.md`](CLAUDE.md) ("CI installs only what is pinned").
The companion browser extension ([steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension)) is archived and no longer a way in.
### 3. Manual: fork + commit (most invasive)
For code changes, or to queue games yourself:
1. Fork → branch.
2. Edit code in `scripts/` / `web/src/` / docs, or append store links to `scripts/temp_info.jsonl`:
```jsonl
{"link": "730"}
{"link": "https://store.steampowered.com/app/570/"}
```
3. Push → open PR. Reviewer (= me) will look when caffeine hits.
A queued line is a link and nothing else: any other key is ignored, and the game is fetched from Steam and checked (free, a game, reachable) before it is published.
---
## Tips for smooth contributions
- **Games must be free-to-play on Steam.** No demos, no paid-now games, no malware-flagged ones.
- **Notes / safe** are worth mentioning in a suggestion ("safe to play", "Toxic max", "Grind phê Easy mode"); the maintainer records them as overrides.
- **Spam / off-topic** issues get closed without comment. Don't be that person.
- **Code style:** match the surrounding file. No hard rules. The Python pipeline is intentionally low-ceremony; the web side (SvelteKit, the Worker, `admin/`) is TS-strict.
- **Tests:** for web changes, `npm run typecheck && npm test && npm run build` must pass (in `web/`). For pipeline changes, `python -m pytest scripts/tests`.
- **Notes / safe** are worth mentioning in an Add or Edit request ("safe to play", "Toxic max", "Grind phê Easy mode"); the maintainer records them as overrides.
- **Spam / off-topic / feature-request** issues get closed without comment. Don't be that person.
- **Questions and chit-chat** go to [Discussions](https://github.com/poli0981/free-steam-games-list/discussions), not issues.
## Code of conduct
@@ -80,4 +122,4 @@ A queued line is a link and nothing else: any other key is ignored, and the game
Thanks for making this noob repo better! Star if you find a hidden gem, or buy me a coffee via [FUNDING.yml](.github/FUNDING.yml) to fuel instant noodles + more sale games ✨
Questions? Open an issue — that's contributing too :))
Questions? [Discussions](https://github.com/poli0981/free-steam-games-list/discussions) — that's contributing too :))
+102 -50
View File
@@ -1,15 +1,32 @@
[![Games Count](https://img.shields.io/badge/Games-3.6k%2B-green?style=flat&logo=steam)](data/)
[![Status](https://img.shields.io/badge/status-stable%20%C2%B7%20maintenance%20only-2ea44f?style=flat)](#project-status)
[![Games Count](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpoli0981%2Ffree-steam-games-list%2Fmain%2Fdata%2Findex.json&query=%24.total&label=Games&color=green&style=flat&logo=steam)](data/)
[![Last Updated](https://img.shields.io/badge/Updated-Daily-blue?style=flat&logo=github-actions)](.github/workflows)
[![Top Online](https://img.shields.io/badge/Top%20Online-Live%20Leaderboard-red?style=flat&logo=steam)](games/top-online.md)
[![Version](https://img.shields.io/badge/version-4.0.0-purple?style=flat&logo=github)](https://github.com/poli0981/free-steam-games-list)
[![Web App](https://img.shields.io/badge/Web%20App-Live-2563eb?style=flat&logo=svelte)](https://free-steam-games.win/)
[![Desktop](https://img.shields.io/badge/Desktop-Tauri%202-FFC131?style=flat&logo=tauri)](https://github.com/poli0981/free-steam-games-list/releases)
[![Android](https://img.shields.io/badge/Android-11%2B%20APK-3DDC84?style=flat&logo=android)](https://github.com/poli0981/free-steam-games-list/releases)
[![Health Check](https://img.shields.io/badge/Health%20Check-Weekly-orange?style=flat&logo=github-actions)](.github/workflows/purge-unhealthy.yml)
[![Health Check](https://img.shields.io/badge/Health%20Check-Daily-orange?style=flat&logo=github-actions)](.github/workflows/purge-unhealthy.yml)
[![Version](https://img.shields.io/github/v/release/poli0981/free-steam-games-list?filter=v*&sort=semver&label=dataset&color=purple&style=flat&logo=github)](https://github.com/poli0981/free-steam-games-list/releases)
[![Desktop](https://img.shields.io/github/v/release/poli0981/free-steam-games-list?filter=desktop-v*&label=desktop&color=FFC131&style=flat&logo=tauri)](https://github.com/poli0981/free-steam-games-list/releases)
[![Android](https://img.shields.io/github/v/release/poli0981/free-steam-games-list?filter=android-v*&label=android%2011%2B&color=3DDC84&style=flat&logo=android)](https://github.com/poli0981/free-steam-games-list/releases)
[![Web App](https://img.shields.io/website?url=https%3A%2F%2Ffree-steam-games.win%2F&label=web%20app&style=flat&logo=svelte)](https://free-steam-games.win/)
[![Web CI](https://github.com/poli0981/free-steam-games-list/actions/workflows/web-ci.yml/badge.svg?branch=main)](https://github.com/poli0981/free-steam-games-list/actions/workflows/web-ci.yml)
[![Python Tests](https://github.com/poli0981/free-steam-games-list/actions/workflows/python-tests.yml/badge.svg?branch=main)](https://github.com/poli0981/free-steam-games-list/actions/workflows/python-tests.yml)
[![CodeQL](https://github.com/poli0981/free-steam-games-list/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/poli0981/free-steam-games-list/actions/workflows/codeql.yml)
[![Qodana](https://github.com/poli0981/free-steam-games-list/actions/workflows/qodana.yml/badge.svg?branch=main)](https://github.com/poli0981/free-steam-games-list/actions/workflows/qodana.yml)
[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=poli0981_free-steam-games-list&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=poli0981_free-steam-games-list)
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=poli0981_free-steam-games-list&metric=coverage)](https://sonarcloud.io/summary/new_code?id=poli0981_free-steam-games-list)
[![Dependabot](https://img.shields.io/badge/Dependabot-enabled-025E8C?style=flat&logo=dependabot)](.github/dependabot.yml)
[![Code: MIT](https://img.shields.io/badge/code-MIT-yellow?style=flat)](LICENSE)
[![Data: CC BY 4.0](https://img.shields.io/badge/data-CC%20BY%204.0-lightgrey?style=flat&logo=creativecommons)](LICENSE-DATA)
[![Node 26](https://img.shields.io/badge/Node-26-5FA04E?style=flat&logo=nodedotjs)](web/.node-version)
[![Python 3.15](https://img.shields.io/badge/Python-3.15-3776AB?style=flat&logo=python)](requirements.txt)
[![SvelteKit 3](https://img.shields.io/badge/SvelteKit-3-FF3E00?style=flat&logo=svelte)](web/README.md)
[![Tauri 2](https://img.shields.io/badge/Tauri-2-24C8D8?style=flat&logo=tauri)](web/src-tauri/TAURI.md)
![Visitors](https://visitor-badge.laobi.icu/badge?page_id=poli0981.free-steam-games-list)
[![Sponsor](https://img.shields.io/badge/Sponsor-Buy%20me%20a%20coffee-ff5f5f?style=flat&logo=buy-me-a-coffee)](.github/FUNDING.yml)
A **curated list** of free-to-play games on Steam — now ~3,600 of them — no quality guarantees, no endorsements, just pure listings by a broke, unemployed Vietnamese dev with too much free time and a Steam library full of sale games (80% under $10).
A **curated list** of free-to-play games on Steam — the badge above has today's count — no quality guarantees, no endorsements, just pure listings by a broke, unemployed Vietnamese dev with too much free time and a Steam library full of sale games (80% under $10).
**v4.0.0** is the version that got rebuilt from the ground up. It is still a list. It is also:
@@ -23,35 +40,54 @@ A **curated list** of free-to-play games on Steam — now ~3,600 of them — no
**Wallet safe (for now). Play at your own risk.**
### Project status
> [!NOTE]
> **Stable, maintenance only (since 2026-11-11).** The project does what it set
> out to do, so it is finished rather than abandoned: the pipeline keeps the
> list fresh every day, and the site and apps stay up.
>
> - **No new features.** Feature requests are not taken, as issues or as pull requests.
> - **Code changes only for** security advisories (CVEs), runtime and dependency
> updates, and whatever those break.
> - **Issues and pull requests are for the data:** adding a game, correcting
> one, removing one. Something broken or an accessibility barrier can still be
> reported; it gets a fix, not a redesign.
> - A vulnerability goes through [`SECURITY.md`](SECURITY.md), never a public issue.
>
> Details in [`CONTRIBUTING.md`](CONTRIBUTING.md).
### Quick links
| Surface | URL |
| -------------------- | -------------------------------------------------------------------------------------------------------------------- |
| 🌐 Web app | <https://free-steam-games.win/> |
| 🖥️ Desktop releases | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (Win `.msi`, Mac `.dmg`, Linux `.AppImage`) |
| 🖥️ Desktop releases | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (Win `.msi` / `.exe`, Mac `.dmg`, Linux `.AppImage` / `.deb` / `.rpm`) |
| 📱 Android APK | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (sideload `.apk`, **Android 11+** — see [`docs/android-support.md`](docs/android-support.md)) |
| 🏆 Top online (md) | [games/top-online.md](games/top-online.md) |
| 🎯 Top offline (md) | [games/top-offline.md](games/top-offline.md) |
| 📦 Raw data | [data/data_001.jsonl](data/data_001.jsonl) … `data_005.jsonl` (5 sharded JSONL files) |
| 📦 Raw data | [data/](data/) — JSONL shards of 800 games each (`data_001.jsonl` …), listed with a SHA-256 each in [`data/index.json`](data/index.json) |
| 🛠️ About | <https://free-steam-games.win/about> (in-app) |
| 👤 Authors | [`AUTHORS.md`](AUTHORS.md) — maintainer + contact channels + AI-assistant disclosure |
| ♿ Accessibility | [`ACCESSIBILITY.md`](ACCESSIBILITY.md) — what works with a keyboard, screen reader and zoom, what doesn't yet, how to report a barrier |
### What's new in v4.0.0
### What's in v4
<details>
<summary><b>Web app at <code>free-steam-games.win/</code></b></summary>
A SvelteKit 2 / Svelte 5 app, prerendered and served by a Cloudflare Worker that also proxies the dataset (`/api/data/*`) and Steam artwork (`/img/*`), so your browser talks to this site only — apart from Cloudflare's analytics beacon and its Turnstile human check, both loaded only after you accept the terms. Features:
A SvelteKit 3 / Svelte 5 app, prerendered and served by a Cloudflare Worker that also proxies the dataset (`/api/data/*`) and Steam artwork (`/img/*`; on the website the art comes from the site's own media host, `media.free-steam-games.win`), so your browser talks to this site only — apart from Cloudflare's analytics beacon and its Turnstile human check, both loaded only after you accept the terms. Features:
- **Browse** — virtualised table (TanStack Virtual), filters for genre, type, platform, status, anti-cheat and safety, Fuse.js fuzzy search, sortable columns, 50/100/200/500/all pages. Filters live in the URL, so a filtered view can be shared.
- **Charts** — Apache ECharts: dashboard KPIs, genres, platforms, languages, tags, anti-cheat (chart and a searchable index), reviews, player tiers, release years and catalogue growth, DRM/DLC, delisted games, plus a stats page (Metacritic, retention, games that went quiet).
- **A page per game** — `/games/:appid` is prerendered for search engines and filled with live player counts and reviews in the browser.
- **Random games** — `/random` rolls one to five games when you cannot decide: online, offline or either, dead games only if you ask, never one marked unsafe. Roll again for a new set; opening a game and coming back keeps the picks.
- **Fresh data, verified** — `data/index.json` carries a SHA-256 per shard; the app only caches a generation it could verify, keeps the last good one offline, and re-checks when you come back to the tab.
- **Installable** — a web app you can install, with an offline mode and an update prompt.
- **i18n** vi / en — auto-detected, switchable from the welcome page or Settings.
- **⌘K command palette**, **first-run introduction**, and the legal documents rendered in the app.
Pushing to `main` deploys (Cloudflare Workers Builds). Pipeline commits to `data/**` do not need a rebuild: the data is proxied, not bundled. See [`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md).
Cloudflare Workers Builds deploys from `main`; which commits trigger a build is in [`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md). Pipeline commits to `data/**` do not need a rebuild: the data is proxied, not bundled.
</details>
@@ -60,7 +96,7 @@ Pushing to `main` deploys (Cloudflare Workers Builds). Pipeline commits to `data
A native shell around the same web app, distributed via [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases):
- Windows `.msi`, macOS `.dmg` (universal Apple Silicon + Intel), Linux `.AppImage` and `.deb`, and an Android `.apk`.
- Windows `.msi` and `-setup.exe`, macOS `.dmg` (universal Apple Silicon + Intel), Linux `.AppImage`, `.deb` and `.rpm`, and an Android `.apk`.
- Resizable window; `steam://` links open the Steam client.
- The desktop app checks for a signed update on start and installs it when you say so, keeping your settings.
- Same data path as the web app (`/api/data/*` on free-steam-games.win), same offline cache.
@@ -78,7 +114,7 @@ npm run tauri:build # release binary into web/src-tauri/target/release/bundle
<details>
<summary><b>The admin at <code>/admin</code></b></summary>
`Discover New Games` sweeps the Steam store daily and proposes candidates into a Cloudflare D1 queue. The maintainer reviews them in a small Svelte app embedded in the Worker (never shipped to visitors): approving commits the store link to `scripts/temp_info.jsonl`, and the pipeline does the rest, checking every game again (free, a game, reachable) before it is published. Approval can also run on its own, in batches with a daily cap, once the maintainer turns it on. Decided and already-published rows are read-only. Corrections to published games are saved as override files that survive every pipeline run, and a removed game goes into `data/blocklist.jsonl`, which keeps it out of the catalogue until it is restored. An overview, the pipeline's runs and a data-quality report complete it. See [`docs/ADMIN.md`](docs/ADMIN.md).
`Discover New Games` sweeps the Steam store daily for free games in every language, not only the ones that support English, and proposes candidates into a Cloudflare D1 queue. The maintainer reviews them in a small Svelte app embedded in the Worker (never shipped to visitors): approving commits the store link to `scripts/temp_info.jsonl`, and the pipeline does the rest, checking every game again (free, a game, reachable) before it is published. Approval can also run on its own, in batches with a daily cap, once the maintainer turns it on. Decided and already-published rows are read-only. Corrections to published games are saved as override files that survive every pipeline run, and a removed game goes into `data/blocklist.jsonl`, which keeps it out of the catalogue until it is restored. An overview, the pipeline's runs and a data-quality report complete it. See [`docs/ADMIN.md`](docs/ADMIN.md).
</details>
@@ -89,8 +125,8 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
- Schema v2.2 (23 + manual fields per record), CC BY 4.0 (see [LICENSE-DATA](LICENSE-DATA)), sharded data in `data/data_*.jsonl` (cap 800 records/shard) plus a `data/index.json` manifest with a SHA-256 per shard.
- HTML scraper for accurate language tables, DLC pricing, user tags and the developer's anti-cheat disclosure — single GET per game.
- Health-checked: dead-link sweep every 5 days, full purge every Monday.
- Reviews-only refresh every 2 days; full refresh daily.
- Health-checked daily: Steam's store API screens every game, and a game is removed only when appdetails agrees.
- Reviews refreshed daily from Steam's own summaries; full refresh daily. Every data job queues for its turn and has a time budget, so a growing catalogue slows a refresh down instead of breaking it ([plan](docs/plan/18-pipeline-scale.md)).
</details>
@@ -100,9 +136,11 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
```
.
├── data/ # Sharded data (the source of truth)
│ ├── data_001.jsonl # ≤ 800 records
│ ├── data_002.jsonl … 005 # the rest
│ └── index.json # last_updated, totals, shard manifest
│ ├── data_001.jsonl … # 800 records per shard, as many shards as it takes
│ ├── index.json # last_updated, totals, shard manifest (SHA-256 each)
│ ├── blocklist.jsonl # removed games, kept out of every write
│ ├── overrides/ # human corrections, re-applied on every write
│ └── snapshots/ # daily per-game players and reviews
│
├── games/ # The two generated leaderboards
│ ├── top-online.md # live leaderboard
@@ -127,7 +165,7 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
│ ├── src-tauri/ # Tauri 2 desktop + Android shell (Rust)
│ └── static/ # icons, social image, robots.txt, _headers
│
├── docs/ # Legal + acknowledgements + contact
├── docs/ # Legal, setup and ops docs, plans (plan/), Vietnamese copies (i18n/vi/)
├── .github/workflows/ # data pipeline, discovery, CI, desktop/Android release
├── LICENSE # MIT — code
└── LICENSE-DATA # CC BY 4.0 — dataset
@@ -151,7 +189,8 @@ scripts/
│ ├── anticheat.py # Steam's anti-cheat disclosure and the rule that applies it
│ ├── steamcharts.py # SteamCharts all-time peak reader (polite, stops on refusal)
│ ├── peaks.py # all_time_peak: only ever raised
│ ├── rotation.py # crc32 daily slices shared by the refresh jobs
│ ├── rotation.py # crc32 daily slices shared by the refresh jobs, growing with the catalogue
│ ├── budget.py # A job's time budget: stop in time to save, warn before it runs out
│ └── health_checker.py # Game status detection with cached API data
├── discover_new.py # Propose new games into the /admin review queue
├── ingest_new.py # Add queued games (health check + fetch from Steam)
@@ -160,13 +199,12 @@ scripts/
├── refresh_store_data.py # Daily rotation: tags/languages weekly, store details monthly
├── refresh_anticheat.py # Daily: every game's anti-cheat, as its developer declares it on Steam
├── refresh_peaks.py # Daily rotation: all-time peak from SteamCharts, monthly per game
├── update_reviews.py # Reviews-only (every 2 days)
├── update_reviews.py # Daily: every game's review summary from Steam, ~2 minutes
├── mark_dead_games.py # Flag online games with no players
├── check_dead_links.py # HEAD-request 404/410 scanner
├── purge_unhealthy.py # Remove delisted/not-free/invalid
├── purge_unhealthy.py # Daily: remove delisted/not-free/unreleased (store API screen + appdetails)
├── top_online.py / top_offline.py # Leaderboards
├── edit_game.py # Overrides from the command line
├── refetch_all.py # Force re-fetch ALL (manual only)
├── refetch_all.py # Force re-fetch, in parts (manual only)
└── delete_game.py # Remove games (blocklist) from the command line
```
@@ -177,51 +215,61 @@ scripts/
| Workflow | Trigger | What it does |
| --------------------- | -------------------------------- | --------------------------------------------------------- |
| Auto Update JSON | Daily 00:00 UTC | Fills in incomplete records (API + HTML scrape) |
| Discover New Games | Daily 05:00 UTC | Propose new free games into the `/admin` review queue |
| Discover New Games | Daily 05:00 UTC | Propose new free games, any language, to the `/admin` queue |
| Ingest New | On `scripts/temp_info.jsonl` or `data/blocklist.jsonl` push, and every 3 h | Apply removals, then add approved games |
| Top Online | Sun/Wed/Fri 03:00 UTC | Live player leaderboard |
| Top Offline | 1st + 15th of month 05:00 UTC | Leaderboard for single-player F2P concurrents |
| Update Reviews | Every 2 days 06:00 UTC | Reviews-only refresh |
| Update Reviews | Daily 06:00 UTC | Every game's review summary from Steam's store API |
| Refresh Store Data | Daily 16:00 UTC | Rotating re-fetch: tags, languages, DLC flag weekly; name, image, description, developer/publisher, release date, platforms, Metacritic, DRM monthly. Then every game's anti-cheat from Steam's disclosure (committed separately; manual run with `only: anticheat` does just that) |
| Refresh All-Time Peaks | Daily 19:30 UTC | `all_time_peak` from SteamCharts, every game once a month, plus our own samples; manual run with `backfill` asks about every game |
| Check Dead Links | Every 5 days 04:00 UTC | HEAD-request 404/410 scanner |
| Purge Unhealthy | Weekly Mon 05:00 UTC | Full health scan + removal |
| Purge Unhealthy | Daily 07:00 UTC | Store API screen of every game; removal once appdetails agrees |
| Mark Dead Games | Mon + Thu 04:30 UTC | Online + >1y + 0 players ≥14d → `is_dead=true` + 💀 note |
| Daily Snapshot | Daily 23:00 UTC | Per-game players and reviews into `data/snapshots/` |
| Force Re-fetch | Manual only | Re-fetch ALL games |
| Force Re-fetch | Manual only | Re-fetch games from scratch, one part (`1/8` … `8/8`) a run |
| Web CI / Python Tests | On `web/**` / `scripts/**` change | Type check, tests, build and output checks |
| Release Desktop / Android | On `desktop-v*` / `android-v*` tag | Build the apps into a draft release |
| Announce Discussion | On release `published` | Auto-create a GitHub Discussion in `Announcements` |
The site itself is deployed by Cloudflare Workers Builds on every push to `main`, not by a workflow.
Also in `.github/workflows/`:
- **CodeQL**, **SonarCloud** and **Qodana** (Python, JS/TS, Rust): code scanning on pushes and pull requests.
- **Check Overrides**: pull requests that touch the override or blocklist files.
- **Backfill Discovery**: temporary; a weekly re-sweep of older release windows into the same `/admin` queue.
- **Announce Release to Discord**: posts each published release.
- Three **Notify** workflows: CI failures, the Pages deploy, the release pipeline.
- **Deploy Web (GitHub Pages)**: it only serves a redirect to the new site now.
The site itself is deployed by Cloudflare Workers Builds, not by a workflow.
### Contribute
The repository is in [maintenance mode](#project-status): contributions are
about the **data**.
New games arrive on their own: `Discover New Games` sweeps the Steam store
daily into a review queue, and the maintainer approves them at `/admin` — by
daily, in every language, into a review queue, and the maintainer approves them at `/admin` — by
hand, or with an auto-approve rule that has a daily cap and is off until turned
on. Discovery only proposes, and every approved game is checked again by the
pipeline (free, a game, reachable) before it is published. Missing a free game
a few days after it went free? Post its store link in
[Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas).
pipeline (free, a game, reachable) before it is published.
The companion browser extension, [steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension),
is archived and no longer a way in.
**Issues** are for reports, not submissions:
[Bug report](.github/ISSUE_TEMPLATE/bug_report.yml),
[Feature request](.github/ISSUE_TEMPLATE/feature_request.yml),
[Delete game](.github/ISSUE_TEMPLATE/delete_game.yml) and
[Feedback](.github/ISSUE_TEMPLATE/feedback.yml). All reviewed by hand.
**The manual way.** Fork, append store links to `scripts/temp_info.jsonl`, and open a pull request:
| You want to | Issue form | Or a pull request that |
| --- | --- | --- |
| **Add** a free game that is still missing a few days after it went free | [Add game](.github/ISSUE_TEMPLATE/add_game.yml) | appends its store link to `scripts/temp_info.jsonl` |
| **Correct** a published game (genre, type, anti-cheat, notes, safe) | [Edit game](.github/ISSUE_TEMPLATE/edit_game.yml) | adds an override with `python scripts/edit_game.py <appid> --set field=value --reason "…"` |
| **Remove** a game (paid now, not a game, malware, duplicate) | [Delete game](.github/ISSUE_TEMPLATE/delete_game.yml) | adds a blocklist line with `python scripts/delete_game.py <appid> --reason <code>` |
```jsonl
{"link": "730"}
{"link": "https://store.steampowered.com/app/570/"}
```
Accepts a full URL, short URL, or bare appid. A line is a link and nothing else: any other key is ignored, and the game is fetched from Steam. A correction to a published game (genre, anti-cheat, notes…) goes in a Discussion; the maintainer records it as an override.
A queued line accepts a full URL, short URL, or bare appid, and is a link and nothing else: any other key is ignored, and the game is fetched from Steam. Never edit `data/data_*.jsonl` or `data/index.json` by hand: the pipeline rewrites them, and an edit there is lost.
Two more forms stay open, for things that are broken rather than wished for:
[Bug report](.github/ISSUE_TEMPLATE/bug_report.yml) and
[Accessibility barrier](.github/ISSUE_TEMPLATE/accessibility.yml). All reviewed by hand.
The companion browser extension, [steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension),
is archived and no longer a way in.
See [CONTRIBUTING.md](CONTRIBUTING.md) for the full flow.
@@ -234,6 +282,7 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
- v2.1 was spaghetti with proper seasoning. It got a scraper.
- v3.0 was spaghetti with a website on top, a desktop app, and bilingual menus.
- **v4.0 is the same spaghetti, rebuilt, with a review queue so it stops needing to be cooked by hand.** Still a hobby.
- v4.7 is where the cooking stops: the dish is served, and from here it is only kept warm.
> [!WARNING]
> **Disclaimer.** Quality / fun / safety: who knows. The maintainer only vouches for games personally played (`safe` column: `y` = yes, `?` = dunno, `n` = nope). Problems with a game are between you, Valve, and the developer of that game — not the maintainer. See [`docs/DISCLAIMER.md`](docs/DISCLAIMER.md) for the specific accuracy caveats.
@@ -241,10 +290,10 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
### Docs
- [AUTHORS](AUTHORS.md) — maintainer + canonical handle map + AI-assistant disclosure.
- [CHANGELOG](CHANGELOG.md) — what changed in each version.
- [CONTRIBUTING](CONTRIBUTING.md) — issue templates, suggesting a game, manual fork.
- [CHANGELOG](CHANGELOG.md) — what changed in each version: the index, with one file per release in [`changelog/`](changelog/).
- [CONTRIBUTING](CONTRIBUTING.md) — maintenance mode, what is accepted, and how to add, correct or remove a game.
- [PC spec](docs/pc_spec.md) ([VI](docs/i18n/vi/pc_spec.md)) — maintainer's dev hardware + test devices.
- [Dev environment](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)) — IDE, toolchains (Python 3.12 / Node 24 / Rust stable / Tauri 2), workflow.
- [Dev environment](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)) — IDE, toolchains (Python 3.15 / Node 26 / TypeScript 7 / Rust stable / Tauri 2), workflow.
- [Tauri build](web/src-tauri/TAURI.md) — desktop build prerequisites + signing + auto-update.
- [DISCLAIMER](docs/DISCLAIMER.md) — accuracy caveats, no-warranty, the broke-maintainer note.
- [Terms of Use](docs/ToS.md) — usage agreement, contributions, governing law.
@@ -257,7 +306,10 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
- [Contact](docs/Contact.md) — where to find the maintainer.
- [CODE OF CONDUCT](CODE_OF_CONDUCT.md) — be chill.
- [SECURITY](SECURITY.md) — vulnerability reporting.
- [`web/README.md`](web/README.md) — stack details, per-phase changelog, build instructions.
- [Security setup](docs/SECURITY_SETUP.md) — the operational side: headers, WAF, rate limits, Access, each with a check command.
- [ACCESSIBILITY](ACCESSIBILITY.md) — what works with a keyboard, screen reader and zoom, what doesn't yet, and how to report a barrier.
- [Android support](docs/android-support.md) ([VI](docs/i18n/vi/android-support.md)) — why Android 11+, and what the APK is tested on.
- [`web/README.md`](web/README.md) — web stack, data paths, CSP, PWA, i18n, build and checks.
Code is [MIT](LICENSE); the dataset is [CC BY 4.0](LICENSE-DATA) with carve-outs for fields the project does not own (`description`, `header_image`). Keep the right licence with you if you fork. Star if you find a hidden gem ✨
+27 -11
View File
@@ -6,17 +6,21 @@ The previous version of this file said the repository was "just a Markdown
list… no executable code, no dependencies, no backend, no user data." That was
wrong on every count, so here is the real picture:
- a **Cloudflare Worker** serving the site, holding a D1 binding and — for the
admin path — a credential that can write to this repository
- a **React single-page app** with a few dozen npm dependencies
- a **Cloudflare Worker** serving the site. It holds a D1 binding, an R2
bucket for the game art (public at `media.free-steam-games.win`), a
15-minute cron (reconcile, auto-approve, and minting the art into that
bucket), and, for the admin path, a credential that can write to this
repository
- a **SvelteKit / Svelte 5 web app**, prerendered to static pages, with a few
dozen npm dependencies, plus the `/admin` app embedded in the Worker
- a **Tauri 2 desktop and Android app**, signed, with an auto-updater
Operational hardening — headers, HSTS, rate limiting, WAF — is documented in
- a **Python pipeline** run by GitHub Actions. The data jobs push to `main`
with the built-in `GITHUB_TOKEN`; the release jobs hold the app signing keys
Operational hardening (headers, HSTS, rate limiting, WAF) is documented in
[`docs/SECURITY_SETUP.md`](docs/SECURITY_SETUP.md), with a check command for
each item.
- a **Python pipeline** run by 23 GitHub Actions workflows, several holding
secrets that can push to `main`
There is genuinely something to attack here. Hence a real policy.
## Reporting
@@ -46,17 +50,21 @@ reproduce. A proof-of-concept URL beats a paragraph of description.
- The Cloudflare Worker (`web/worker/**`) — the data proxy, the image proxy,
and anything reachable under `/api/*`
- The `/admin` path and its Cloudflare Access gate
- The `/admin` path and `/api/ingest/*`, and their Cloudflare Access gates
- The D1 database and anything that writes to it
- The media host, `media.free-steam-games.win` (the R2 bucket's public
domain), and whatever the cron writes to it
- The GitHub Actions workflows, especially any path where untrusted input
reaches a step that can push to `main`
- The Tauri updater and its signing key
- The Tauri updater, its signing key, and its feed at `/api/updates/desktop`
- Dependency vulnerabilities that are actually reachable from shipped code
Things worth probing specifically: making `/img/*` fetch an origin that is not
`shared.akamai.steamstatic.com` or `shared.fastly.steamstatic.com`; making
`shared.akamai.steamstatic.com` or `shared.fastly.steamstatic.com` (or, for
the avatars under `/img/gh/*`, `avatars.githubusercontent.com`); making
`/api/data/*` return a path outside its allowlist; reaching admin
functionality without an Access session.
functionality without an Access session; getting the update feed to offer a
file that is not this repository's release download.
## Out of scope
@@ -72,6 +80,8 @@ functionality without an Access session.
already read. A way to make `/api/human-check` accept a token Cloudflare
rejected is in scope.
- Social engineering of the maintainer.
- Accessibility barriers. They are real bugs, but not security ones: see
[`ACCESSIBILITY.md`](ACCESSIBILITY.md).
## What to expect
@@ -86,3 +96,9 @@ broke are not a joke. Credit in `docs/ACKNOWLEDGEMENTs.md` if you want it.
The deployed site and `main` are the only supported versions. Desktop and
Android releases are supported at the latest tag only; there are no backports.
The project is stable and in maintenance mode (see
[`CONTRIBUTING.md`](CONTRIBUTING.md)): no new features are developed, and
security fixes and runtime / dependency updates are exactly what it is still
maintained for. Dependabot, CodeQL and SonarCloud keep running, and a fix
ships as a new site deploy and, when the apps are affected, a new app release.
+6 -7
View File
@@ -1,13 +1,12 @@
#!/bin/bash
# Commit what a data job changed, and push it even if main moved meanwhile.
#
# A data job can run for hours (update-reviews, check-dead-links,
# purge-unhealthy), and `concurrency: data-write` serialises only the
# WORKFLOWS. main still moves underneath one: a merged pull request, an /admin
# approval, removal or override the Worker commits. A plain `git push` is then
# rejected ("fetch first")
# and the whole run is thrown away - purge-unhealthy lost four hours of work
# that way on 2026-09-21.
# A data job can run for an hour or more (refresh-store-data, the
# leaderboards), and `concurrency: data-write` serialises only the WORKFLOWS.
# main still moves underneath one: a merged pull request, an /admin approval,
# removal or override the Worker commits. A plain `git push` is then rejected
# ("fetch first") and the whole run is thrown away - purge-unhealthy lost four
# hours of work that way on 2026-09-21.
#
# None of those other writers touch the shards, so rebasing onto them and
# pushing again is safe. A genuine conflict still fails the job, loudly.
-5
View File
@@ -1,5 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
python scripts/check_dead_links.py
bash "$(dirname "$0")/commit_push.sh" "Dead link check [$(date +'%Y-%m-%d')]"
+4 -3
View File
@@ -3,9 +3,10 @@
#
# remove_games.py applies data/blocklist.jsonl (games the maintainer removed in
# /admin or with delete_game.py) before ingest_new.py adds the queued links.
# One workflow does both on purpose: `data-write` keeps ONE pending run and a
# newer one evicts it, so a separate removal workflow and the ingest would keep
# cancelling each other. Whichever run survives does both.
# One workflow does both: a commit to either file starts one run that settles
# the two, in that order. (It was also the only way to do it while
# `data-write` kept a single pending run and a separate removal workflow and
# the ingest kept evicting each other; the group queues them now.)
set -euo pipefail
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
python scripts/remove_games.py
+7
View File
@@ -1,5 +1,12 @@
#!/bin/bash
set -euo pipefail
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
# PURGE_DRY_RUN is the manual run's "dry run" box: screen and confirm, remove nothing.
# A guard that trips (too many flagged or confirmed) exits non-zero before
# anything is written, so set -e stops here and nothing is committed.
if [[ "${PURGE_DRY_RUN:-}" == "true" ]]; then
python scripts/purge_unhealthy.py --dry-run
exit 0
fi
python scripts/purge_unhealthy.py
bash "$(dirname "$0")/commit_push.sh" "Purge unhealthy [$(date +'%Y-%m-%d')]"
+6 -3
View File
@@ -1,7 +1,10 @@
#!/bin/bash
set -euo pipefail
echo "── Force re-fetch ALL games (v2.1 schema) ──"
# REFETCH_PART is the manual run's "part" box, K/N (scripts/refetch_all.py
# checks it): the whole catalogue no longer fits in one job.
part="${REFETCH_PART:-1/1}"
echo "── Force re-fetch, part ${part} ──"
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
python scripts/refetch_all.py
bash "$(dirname "$0")/commit_push.sh" "Force re-fetch all games → v2.1 schema [$(date +'%Y-%m-%d')]"
python scripts/refetch_all.py --part "$part"
bash "$(dirname "$0")/commit_push.sh" "Force re-fetch, part ${part} [$(date +'%Y-%m-%d')]"
+5
View File
@@ -1,5 +1,10 @@
#!/bin/bash
set -euo pipefail
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
# REVIEWS_DRY_RUN is the manual run's "dry run" box: read Steam, write nothing.
if [[ "${REVIEWS_DRY_RUN:-}" == "true" ]]; then
python scripts/update_reviews.py --dry-run
exit 0
fi
python scripts/update_reviews.py
bash "$(dirname "$0")/commit_push.sh" "Update reviews [$(date +'%Y-%m-%d')]"
+14
View File
@@ -0,0 +1,14 @@
# Changelog files
One file per release, newest version first in the index:
[`CHANGELOG.md`](../CHANGELOG.md) at the root lists them all, with what is not
released yet.
- `v<major>/<major>.<minor>.x/<version>.md` - a release, e.g.
[`v4/4.7.x/4.7.1.md`](v4/4.7.x/4.7.1.md). Its first line is the release
heading; the rest is the release notes, which is also what the GitHub
release of that tag says.
- [`beta/`](beta/) - pre-releases (none so far).
A file is written once, when its version is released, and is not reworded
afterwards: it records what was true then, links and file names included.
+9
View File
@@ -0,0 +1,9 @@
# Pre-releases
Notes for a beta, alpha or release candidate go here, one file per
pre-release, named for its version: `5.0.0-beta.1.md`. When the line goes
stable its release gets a file of its own under `v<major>/`; the beta files
stay, as the record of what changed during the run-up.
None has been published: every release so far, v1.0.0 to the latest in
[`CHANGELOG.md`](../../CHANGELOG.md), was a stable one.
+20
View File
@@ -0,0 +1,20 @@
# v1.0.0 - 2025-12-22 (Initial stable release)
[All versions](../../../CHANGELOG.md)
From the GitHub release of v1.0.0 ("v1.0.0 - Released"); the changelog
itself starts with v1.1.0.
First stable release – the repo is alive!
- Auto daily fresh stats + immediate update on data.json push
- Tables with thumbnails, reviews sort best first, safe/noob notes
- Genre files + top online multiplayer
- Chained workflows, robust fetch/generate
- Bug/feature templates
From a broke unemployed Vietnamese dev (Easy mode only) + Grok AI buddy 70% power.
Thanks for starring/watching – wallet safe, play free games :))
Next? More games, more noob notes, maybe dynamic badges if not lazy.
+10
View File
@@ -0,0 +1,10 @@
# v1.1.0 - 2025-12-30 (Scale Noob Edition)
[All versions](../../../CHANGELOG.md)
- Split all-games.md into parts. Smart fetch skip. Wiki. Issue templates.
- Batch + delay optimize for 500+ games. Various Action fixes.
Previous: [v1.0.0] – Initial stable.
Made with boredom, instant noodles, sale addiction, and AI power ✨
+5
View File
@@ -0,0 +1,5 @@
# v1.1.1 - 2026-01-07
[All versions](../../../CHANGELOG.md)
- 50+ games, delete/dedup scripts, CSV export, auto CSV Actions. (by [@poli0981](https://github.com/poli0981))
+5
View File
@@ -0,0 +1,5 @@
# v1.1.2 - 2026-01-11
[All versions](../../../CHANGELOG.md)
- 40+ games added.
+8
View File
@@ -0,0 +1,8 @@
# v1.1.3 - 2026-01-15
[All versions](../../../CHANGELOG.md)
From the message of the tag `v1.1.3`; it has no GitHub release and
had no section in the changelog.
- 30+ games added.
+17
View File
@@ -0,0 +1,17 @@
# v2.0.0 - 2026-03-26 (The "Finally Got Serious" Edition)
[All versions](../../../CHANGELOG.md)
## 💥 Breaking Changes
- Data format migrated from `data.json` to `data.jsonl` (JSON Lines).
- All Python scripts rewritten from scratch under `scripts/core/` modular architecture.
- Bash scripts rewritten with `set -euo pipefail`.
## 🏗️ Architecture (Complete Rewrite)
- Modular core: `constants.py`, `steam_client.py`, `data_store.py`, `fetcher.py`, `health_checker.py`.
- Rate-limited HTTP client with backoff, retry, 429 handling, session pooling.
- Health detection (5 statuses), purge, dead link check, pre-flight ingest validation.
- New ingest flow: `temp_info.jsonl` → validate → dedup → health check → fetch → `data.jsonl`.
- 9 CI/CD workflows. Metacritic, DRM, Peak Today, Status columns. Top Online leaderboard with trends.
+85
View File
@@ -0,0 +1,85 @@
# v2.1.0 - 2026-03-28 (The "Extension-Ready + Performance" Edition)
[All versions](../../../CHANGELOG.md)
## 💥 Breaking Changes
- `desc` field **removed** from schema. Use `description` only. Migration script handles upgrade automatically.
- `free_type` field removed (unreliable from API, extension handles classification client-side).
- `jsonlines` pip dependency dropped – all I/O now uses stdlib `json` (faster, zero deps).
- `fetcher.py` function renamed: `_process_batch()` → `process_batch()` (public API).
## 🏗️ Schema v2.1 (Extension-Compatible)
- **7 new fields** added to every game record, matching Chrome extension output:
- `publisher` (list) – e.g. `["Square Enix", "Feral Interactive (Mac)"]`
- `platforms` (list) – e.g. `["Windows", "macOS", "Linux"]`
- `languages` (list) – e.g. `["English", "French", "Japanese"]`
- `language_details` (list[dict]) – per-language `{name, interface, audio, subtitles}` booleans
- `tags` (list) – all user-defined Steam tags including hidden overflow
- `anti_cheat_note` (str) – raw anti-cheat name from store page
- `is_kernel_ac` (bool|null) – `true` = kernel-level, `false` = non-kernel, `null` = unknown
- `developer` normalized: string → list everywhere (API, extension, migration).
- `desc` merged into `description`, then dropped. One field, no duplication.
## 🔌 Extension Data Integration
- New `merge_extension_data()` in `data_store.py` – smart merge with 3-tier priority:
- **MANUAL_FIELDS** (notes, safe, type_game, genre, anti_cheat): only fill if empty (preserves user edits).
- **ARRAY_FIELDS** (developer, publisher, platforms, languages, tags): replace wholesale (extension data is richer).
- **Other fields**: overwrite if extension provides non-empty value.
- `ingest_new.py` now accepts full extension output (20+ fields per entry) – merges before fetch, re-applies manual
overrides after fetch.
- Ingest summary shows field counts: `dev=DONTNOD plat=[Windows, macOS, Linux] langs=6 tags=20`.
## 🔍 HTML Scraper (New Module)
- New `scraper.py` – extracts data unavailable from Steam API:
- **Language table**: parses `<table class="game_language_options">` → accurate Interface/Audio/Subtitles per
language (API only gives a broken HTML string with no subtitle info).
- **DLC pricing**: parses `#gameAreaDLCSection` → checks `data-price-final` per DLC row. Only marks
`has_paid_dlc=true` if at least one DLC has actual non-zero price (API just lists DLC IDs with no prices).
- **Tags**: parses `.app_tag` elements including `display:none` overflow tags (API `appdetails` doesn't return user
tags at all).
- All 3 extracted from **single GET request** to store page – one HTML fetch per game, not three.
- 8 regex patterns pre-compiled at module level.
## ⚡ Performance Optimizations
- **Eliminated double-fetch in ingest**: `health_checker` now caches API response in `HealthResult.data`.
`ingest_new.py` passes `prefetched_details=health.data` to `fetch_full()` → skips redundant `fetch_app_details()`
call. Saves 1 API request per game (300 games = ~450s saved).
- **Dropped jsonlines dependency**: `load_jsonl()` uses `json.loads()` line-by-line, `save_jsonl()` uses
`json.dumps()` + `f.write()` directly. ~20-30% faster I/O for large files, zero pip deps for core.
- **Pre-compiled regex**: `scraper.py` compiles all 8 patterns at import time, not per-call. 300 games = 8 compiles
instead of 2400.
- **Faster `is_empty()`**: uses `frozenset` lookup for empty string variants, early returns for `None`/`list`.
- **`SteamClient.__slots__`**: reduced memory per instance, faster attribute access.
- **`extract_appid()` regex simplified**: `/app/(\d+)` instead of full domain match – shorter, same correctness.
- **`make_skeleton()` template**: shallow-copies from frozen template dict instead of building from scratch.
- **`generate_tables.py`**: `lines.extend(generator)` instead of `append()` loop.
## 🔄 New Scripts & Workflows
- `refetch_all.py` + `refetch-all.yml` – **manual-only** force re-fetch of ALL games into v2.1 schema. Creates backup →
migrates → clears fetchable fields → re-fetches from Steam API + HTML scrape. Preserves manual fields (notes, safe,
type_game). Requires typing `"yes"` to confirm. Timeout: 120 minutes.
- `migrate_schema.py` + `migrate-schema.yml` – upgrades existing `data.jsonl` records: adds missing fields, normalizes
types, drops deprecated fields. Idempotent.
## 🐛 Bug Fixes
- **`languages` corrupted**: API HTML string `"Brazil<br>languages with full audio"` was parsed as
`"Brazillanguages..."`. Fixed by switching to HTML table scraping.
- **`subtitles` always `false`**: API has no subtitle breakdown. Fixed by parsing store page language table (
Interface/Audio/Subtitles columns).
- **`has_paid_dlc` false positives**: Games with free-only DLC were marked `true`. Fixed by scraping actual
`data-price-final` attributes.
- **`description` duplicated**: Both `desc` and `description` stored same text. Unified to `description` only.
## 🧹 Improved
- Tables: Publisher column, Platforms column, Language count, kernel anti-cheat badge (🔴/🟢).
- `health_checker.py`: `@dataclass(slots=True)` for leaner objects.
- `top_online.py`: tier thresholds as tuple list (cleaner).
- All scripts: consistent `sys.path.insert(0, ...)` for imports.
+50
View File
@@ -0,0 +1,50 @@
# v3.0.0 – 2026-05-07 (The "It Has a Website Now" Edition)
[All versions](../../../CHANGELOG.md)
The repo is no longer just a list. It is a **list + a React/Vite web app + a Tauri desktop app**, all reading the same Python-pipeline-maintained data.
## 🌐 Web app — `web/` + GitHub Pages
Built across phases 1 → 7. Live at <https://poli0981.github.io/free-steam-games-list/>.
- **Phase 1** — read-only browse: virtualised 1.2k-row TanStack table, faceted filters, Fuse.js fuzzy search, 4 ECharts MVP charts (KPI, top-online, genre treemap, platform donut), GitHub Pages deploy via `actions/deploy-pages`.
- **Phase 2** — PAT-based GitHub auth, single-record edit drawer for the 8 manual fields, diff viewer, single + bulk Steam-link queue into `scripts/temp_info.jsonl`, conflict-retry, sonner toasts.
- **Phase 3** — client-side OpenPGP signing via Git Data API: switched all writes from Contents API to `commitFile(getHead → createBlob → createTree → buildCommitContent → openpgp.sign → createCommit → updateRef)`. Settings panel with passphrase unlock + lock indicator. Earlier claim that PATs auto-sign was wrong — Contents API commits land Unverified.
- **Phase 4** — fixed GPG salt-notation incompatibility (`config.nonDeterministicSignaturesViaNotation: false`) so OpenPGP.js v6 signatures parse on GitHub. Bulk edit + bulk delete in one signed multi-shard commit. 8 remaining charts (tags wordcloud, AC stacked, languages heatmap, release-year histogram, catalog-growth cumulative line, reviews histogram, online player tiers pie, DRM/DLC bars). Health page with workflow_dispatch buttons. ⌘K command palette (cmdk).
- **Phase 4.1** — GPG signature payload fix: dropped trailing `\n` after the commit message so our signed bytes match `verification.payload` byte-for-byte. Verified via `gh api .../commits/{sha}.commit.verification.reason → valid`.
- **Phase 5** — PWA (installable, offline shell + last-known data via Workbox), GPG identity override (multi-UID picker), GPG idle auto-lock 5/15/30/60 min, Activity feed page (`/activity`) with Verified-status badges + Me/Bots/All filters.
- **Phase 6** — curated enums (`ANTI_CHEAT_ENUM`, `GENRE_ENUM`) + dropdowns, JSON-editor toggle in the edit drawer (full-record replace), manual-field overrides on Add (single + bulk JSON mode propagates `genre/type_game/anti_cheat/notes/safe` straight into `temp_info.jsonl`), GamesTable pagination 50/100/200/500/all + hidden scrollbar + per-row validation badge, per-game permalinks `/games/:appid` with friendly 404 drawer, verify-after-commit polling (toast updates with `verification.reason` once GitHub confirms), CSV/JSON export of the filtered subset, About page (repo + dev info from `username.txt` + 3rd-party stack + issue templates), topbar GPG quick-unlock popover, owner-gate (`useIsOwner` + `OWNER_LOGIN`) hides edit/add/delete UI from non-owners.
- **Phase 6.1** — Edit Always Failing fix: Contents API caps `content` at 1 MB; `data/data_001.jsonl` is 1.49 MB so the read came back empty and every edit threw "Record not found". New `getRepoFileText()` helper falls back to the `/git/blobs/{sha}` endpoint for oversize files.
- **Phase 6.2** — stale-after-edit fix: bumped `data/index.json.last_updated` in every shard-modifying commit AND switched the SW cache to `NetworkFirst` (raw.github CDN is Fastly-cached for 5 min). Plus optimistic-update helpers (`optimisticEdit/Replace/BulkEdit/BulkDelete`) write straight to TanStack + IndexedDB so the editor sees their own change instantly without waiting for the CDN.
- **Phase 7** — date-column sort fix (`parseReleaseDate`), hamburger mobile nav (Sheet drawer, auto-close on route change), About expansion (Heads-up caveats + AI disclosure + legal links + per-third-party SPDX licence badges), legal docs rewritten (DISCLAIMER + EULA + ToS + PRIVACY) with the four caveats from `notes.txt` (genre best-effort, English-only, test-data leakage, unsigned-commit dev artefacts), refreshed `bug_report.yml`, workflow Node 20 → 24 + actions versions bumped.
## 🌍 i18n — vi / en (Phase 8, this release)
- `react-i18next` + `i18next-browser-languagedetector`. Resource files `src/i18n/locales/{en,vi}.json`.
- Auto-detect from `navigator.language` on first load; persistent override via Settings → Language.
- Sidebar nav, Topbar, Settings, Dashboard, Top Online, common buttons, common toast strings translated. Long-form legal copy stays English by design (legal review hard to mirror exactly across two languages).
## 🖥️ Desktop app — Tauri 2 (Phase 8, this release)
- `web/src-tauri/` Rust scaffold targeting Tauri 2. Single `main` window, fixed 1400 × 900, no resize, no maximise, dark theme, centred at startup.
- `tauri-plugin-shell` for opening external links to Steam / GitHub from the embedded UI.
- New `release-desktop.yml` workflow: matrix `ubuntu-latest` / `windows-latest` / `macos-latest`, Apple Silicon + Intel universal binaries, `tauri-apps/tauri-action`. Triggered by `desktop-v*` tags or manual workflow run. Each run creates a draft GitHub Release with `.msi` / `.dmg` / `.AppImage` / `.deb` assets.
- `npm run tauri:dev` and `npm run tauri:build` from `web/` for local builds.
## 📦 Versioning
- Repo version badge **2.1.0 → 3.0.0**.
- `web/package.json` **0.1.0 → 1.0.0** (web app considered first-stable).
- `web/src-tauri/Cargo.toml` and `tauri.conf.json` ship at `1.0.0`.
## 📝 Docs (this release)
- `README.md` — rewrite: web app + desktop sections, updated Quick Links table, new architecture diagram, refreshed contribute paths, refreshed docs index.
- `CHANGELOG.md` — this entry consolidating phases 1 → 8.
- `docs/ACKNOWLEDGEMENTs.md` — refreshed with phase-by-phase AI assistance breakdown (Grok v1; Claude for v2 + the entire web/desktop layer + this changelog).
- `web/README.md` — phase 8 status appended.
## 🛠️ Pipelines unchanged
- All 9 v2.x Python pipeline workflows (update-json, generate-tables, top-online, update-reviews, dead-link-check, purge-unhealthy, ingest-new, ingest-from-issue, refetch-all) keep their schedules and behaviour. Two new workflows added: `deploy-pages.yml` (Phase 1) and `release-desktop.yml` (Phase 8).
+48
View File
@@ -0,0 +1,48 @@
# v3.0.1 – 2026-05-07 (The "Desktop Actually Ships This Time" Edition)
[All versions](../../../CHANGELOG.md)
Same-day post-v3.0.0 maintenance covering Phase 9 (auto-update foundations + CVE bumps + Device Flow scaffold), Phase 10 (Tauri build break + i18n full coverage + deps audit), and Phase 10.1 (minisign keypair rotation). The desktop release pipeline is now end-to-end green — `desktop-v1.0.0` finally produces signed `.msi` / `.exe` / `.dmg` / `.AppImage` / `.deb` / `.rpm` artefacts with a valid `latest.json` for auto-update.
## 🖥️ Phase 9 — auto-update foundations (#56)
- `tauri-plugin-updater` wired into `web/src-tauri/`. Endpoint pinned to the Releases page so installed clients fetch `latest.json` on launch.
- Updater pubkey embedded in `tauri.conf.json` (gated behind a no-op for mobile builds via `#[cfg(not(any(target_os="android", target_os="ios")))]`).
- GitHub Device Flow scaffold added to Settings: signed-in users no longer have to paste a long-lived PAT — they kick off `https://github.com/login/device`, type the user_code, and the app polls until token issuance. Falls back to PAT for the offline path.
- Dependency CVE bumps (vite 5 → 7, vite-plugin-pwa 0.20 → 1.x). Path-traversal fix in source-map handling. No source changes required for the bumps.
- More i18n: a chunk of edit-drawer / activity / dashboard chrome got proper translation keys.
## 🛠️ Phase 10 — Tauri build break + full i18n + deps audit (#57)
- **Tauri lib-name regression fixed.** Phase 9's auto-updater work introduced a `f2p_tracker_lib::run()` call in `main.rs` without declaring `[lib]` in `Cargo.toml`. Cargo's implicit lib name is `f2p_tracker` (hyphens → underscores from the package name) so the call failed to resolve and `cargo build` blew up. Added the explicit Tauri-2-template-style block:
```toml
[lib]
name = "f2p_tracker_lib"
crate-type = ["staticlib", "cdylib", "rlib"]
```
The triple crate-type keeps the door open for future `tauri ios init` / `tauri android init` work that `lib.rs`'s `#[cfg_attr(mobile, tauri::mobile_entry_point)]` already implies.
- **i18n now reaches every chrome surface** (~150 new keys across new namespaces `charts`, `activity`, `add`, `system`, `cmdk`, `about`, `bulk`, `detail`, `diff`, `dialogs`, `health`). All 9 chart pages, Activity, Add, Health, Top Online, About headings, drawers (Edit / BulkEdit / Diff / GameDetail), `PwaIndicator`, `QueryState`, `GpgQuickUnlock`, `Topbar` tooltips/aria-labels, `Settings` rate-limit panel, `BulkActionBar` confirm dialog, `GamesTable` tooltips, and `CommandPalette` resolve through `useTranslation`. Long-form About prose stays English per the `settings.languageHint` policy. Enum values (anti-cheat / genre / type_game / safe) stay dataset-stable.
- **Third-party deps audit.** Walked `web/package.json` against `About → Stack & third-party` and `docs/ACKNOWLEDGEMENTs.md`. Added missing entries: `react-router-dom`, the i18next stack (`i18next` + `react-i18next` + `i18next-browser-languagedetector`), Tauri 2 + plugins (shell / updater / process), `echarts-for-react`, the styling utilities (`class-variance-authority` / `clsx` / `tailwind-merge` / `tailwindcss-animate`), and PostCSS + autoprefixer. Vite version corrected 5 → 7 (was already bumped by Phase 9; About just hadn't caught up).
- `ACKNOWLEDGEMENTs.md` restructured into grouped sections (runtime/build, styling, UI primitives, routing & i18n, data & state, charts, crypto & PWA, desktop) with deep links + SPDX licences.
- `web/src-tauri/Cargo.lock` now committed for reproducible desktop builds.
## 🔑 Phase 10.1 — minisign keypair rotation (#58)
- `desktop-v1.0.0` was failing at the final sign-updater-bundle step:
```
failed to decode secret key: incorrect updater private key password:
Missing comment in secret key
```
minisign formats the error so the inner "Missing comment" is the symptom of a wrong password — when the password is wrong, decryption returns garbage and the expected `untrusted comment: minisign encrypted secret key` header bytes don't appear. The original keypair's password was lost, so the GH secret could no longer decrypt the key.
- Re-keyed via `npx tauri signer generate --ci -p ""` with no password. Stored at `~/.tauri/f2p-tracker{,.pub}` on the maintainer's box; `web/src-tauri/.gitignore` extended (`*.key`, `f2p-tracker{,.pub}`) as a guardrail in case keys ever land in `src-tauri/` during dev.
- New pubkey baked into `tauri.conf.json` `plugins.updater.pubkey`. GH secrets `TAURI_SIGNING_PRIVATE_KEY` and `TAURI_SIGNING_PRIVATE_KEY_PASSWORD` rotated via `gh secret set` (password = empty string).
- **Trade-off**: any user already on a build signed with the old key would have their auto-update break. Nobody hit that path because Phase 9 / Phase 10 release runs both failed before publishing artefacts. Phase 10.1's rebuild is the first actually-shipped `desktop-v1.0.0`.
## 🏷️ Tag handling
- `desktop-v1.0.0` was force-pushed twice in this cycle as the workflow input commit advanced (Phase 9 → Phase 10 → Phase 10.1). The triggering tag is GPG-signed each time. Once the auto-update story is real users-on-it, future fixes should bump `desktop-v1.0.x` instead of force-pushing.
## 📝 Docs (this release)
- `CHANGELOG.md` — this entry.
- `web/src-tauri/Cargo.toml` + `tauri.conf.json` + `.gitignore` — Phase 10 / 10.1 changes documented in their own commit messages and PR bodies (#57, #58).
+60
View File
@@ -0,0 +1,60 @@
# v3.1.0 – 2026-05-09 (The "Less CI Noise, Lighter Images, Dead-Game Detection" Edition)
[All versions](../../../CHANGELOG.md)
Four PRs landed in this release plus a refresh of the docs and the contributor surface around the new Telegram bot. Web app + desktop app bumped from `1.0.0` → `1.1.0`. Repo public-facing version `3.0.1` → `3.1.0`. Tag `v3.1.0` is GPG-signed; companion desktop tag is `desktop-v1.1.0`.
## 🛠️ CI hygiene — notify wrappers (#60)
- The 3 notify wrappers (`notify-ci-failure`, `notify-deploy`, `notify-release-pipeline`) used to trigger on `workflow_run: workflows: ["*"]` and were filtered out by their reusable callee's `if:` — 95–100 % of runs showed as "skipped". Replaced the catch-all with explicit lists of source workflow `name:` strings per wrapper, plus job-level `if:` to short-circuit non-matching conclusions. Drops skip rate to <10 %.
- Trade-off documented in each file: renaming a source workflow's `name:` field silently breaks notifications; comment warns about the coupling.
## 🖼️ Image optimisation — capsule swap + WebP via wsrv.nl (#61)
- `scripts/generate_tables.py:68` — markdown thumbnails now use `capsule_184x69.jpg` instead of `header.jpg` (~80 % bandwidth reduction at the same 120 px render width).
- Web app `GamesTable` + `CommandPalette` — capsule swap with explicit `width`/`height` to eliminate CLS, plus `onError` fallback to `header.jpg` for the ~5 % of games without a capsule variant.
- `GameDetailDrawer` — `<picture>` element with WebP source via `images.weserv.nl` proxy + JPEG fallback. Lazy-loaded, explicit dimensions.
- `vite.config.ts` — new `CacheFirst` runtime cache for `images.weserv.nl` (`statuses: [200]` only — opaque 0-status would cache proxy errors).
- New helper `web/src/lib/image.ts` — `headerToCapsule()` + `webpProxyUrl()`.
## 💀 Dead-game detection — `mark-dead-games.yml` (#62)
- New cron `Mon + Thu 04:30 UTC` flags **online games released >1 year ago** whose `current_players == 0` for **≥14 days** (configurable via `DEAD_GAME_DAYS` env or `--days` CLI). On trigger: `is_dead = true` + `"💀 Dead game"` appended to `notes` (idempotent).
- **State model**: ISO timestamp `zero_player_since` (robust against schedule drift), not a streak counter.
- **Mark mechanism**: additive `is_dead: bool` + note. `status` stays `"active"` so the existing enum / Top Online filter / chart groupings don't break. Web app gains a "Hide dead" filter toggle and a 💀 emoji prefix on dead rows.
- **Dry-run available**: `python scripts/mark_dead_games.py --dry-run --days 0` for auditing without writes.
- New helper `append_note_idempotent()` in `scripts/core/data_store.py`. Retrofitted onto `check_dead_links.py` to fix duplicate `"💀 Delisted"` accumulation on reruns.
- Schema migration via `_SKELETON_TEMPLATE` only (no one-shot script). Both the Python pipeline and the React app inherit defaults via existing `migrate_record()` / `migrateRecord()` loops.
## 🔄 Concurrency unification
All data-mutating workflows now share `concurrency: { group: data-write, cancel-in-progress: false }`:
- `update-json`, `update-daily`, `top-online`, `update-reviews`
- `check-dead-links`, `purge-unhealthy`, `mark-dead-games` (new)
- `ingest-new`, `ingest-from-issue`, `bot-ingest`, `refetch-all`
Prevents races on `git push` to `data/` shards. Bot-ingest moved from its own `bot-ingest` group to the unified group.
## 📝 Docs + contributor surface (this PR)
- **`AUTHORS.md`** at repo root — handle map for the maintainer, AI-assistant disclosure, MIT licensing reminder.
- **`username.txt`** extended with `telegram bot`, `telegram user`, and `email` lines (canonical machine-readable handle map mirrored by `AUTHORS.md`).
- **`assets/qr/`** — QR-code PNGs for `@my_skull_bot` and `@SkullMute0011` (mirrored to `web/public/qr/` so the SPA can serve them). Generated via `python -m qrcode`.
- **`web/src/pages/About.tsx`** — Maintainer card now lists Telegram bot + Telegram DM (with QR thumbnails inline) + Email. New "Telegram QR codes" card with full-size scannable codes. Privacy note about Telegram `user_id` handling.
- **`CONTRIBUTING.md`** rewrite — adds the `@my_skull_bot` flow as a first-class contribution path (find `user_id` → DM maintainer privately → whitelist → run when bot's online → follow prompts). Loud privacy warning at the top.
- **`docs/PRIVACY_POLICY.md`** — new "Telegram bot" section covering the `user_id` data flow, where it's stored, retention/removal, and the maintainer's commitment.
- **`docs/ToS.md`** — new section 5.1 "Sharing personal information when contributing" with non-negotiable rules about private vs public channels.
- **`docs/Contact.md`** — Telegram bot + DM entries added at the top.
- **README** badges and feature list refreshed (version bumped, dead-game workflow listed, About-page QR card mentioned).
## 🔢 Versioning
| Surface | Old | New |
|---|---|---|
| Repo public-facing | 3.0.1 | **3.1.0** |
| `web/package.json` | 1.0.0 | **1.1.0** |
| `web/src-tauri/Cargo.toml` | 1.0.0 | **1.1.0** |
| `web/src-tauri/tauri.conf.json` | 1.0.0 | **1.1.0** |
| Git tag (signed) | `v3.0.1` | `v3.1.0` |
| Desktop tag (signed) | `desktop-v1.0.0` | `desktop-v1.1.0` |
+74
View File
@@ -0,0 +1,74 @@
# v3.2.0 – 2026-05-11 (The "SEO + Donate + Auto-Discussion + Health Polish + Dev Docs" Edition)
[All versions](../../../CHANGELOG.md)
Single-PR bundle (#64) shipping eight features on top of v3.1.0. Web app + desktop bumped from `1.1.0` → `1.2.0`. Repo public-facing version `3.1.0` → `3.2.0`. Tag `v3.2.0` is GPG-signed; companion desktop tag is `desktop-v1.2.0`.
## 🔍 SEO basics
- `web/index.html` — full Open Graph block (`og:type`, `og:title`, `og:description`, `og:url`, `og:image`, `og:site_name`, `og:locale` + alternate), Twitter Card (`summary`), `<link rel="canonical">`, `meta name="author"`, JSON-LD (`WebSite` + `Person` + `SoftwareApplication`).
- New `web/public/robots.txt` (allow all + sitemap pointer) and `web/public/sitemap.xml` (5 entries: site root, GitHub repo, all-games / top-online / changelog markdown).
- New hook `web/src/hooks/useDocumentTitle.ts` — sets `document.title` to `<page> · Steam F2P Tracker` and re-runs on language change. Wired into all 18 routes (Dashboard / Games / TopOnline / Health / Activity / Add / About / Donate / Settings / 9 charts).
- VitePWA already emits `manifest.webmanifest` from `vite.config.ts`; no manual manifest needed.
## 💬 Auto-create GitHub Discussion on release
- New `.github/workflows/announce-release-discussion.yml` — fires on `release: published` (plus `workflow_dispatch` with a `tag` input for re-runs).
- Implemented via `actions/github-script@v8` + GraphQL `createDiscussion` (REST has no equivalent).
- Resolves the discussion category by slug — defaults to `Announcements`, falls back to `General` with a logged warning, then to the first available category.
- **Idempotent**: a GraphQL search runs first; if a discussion with the same title exists, the workflow skips with `core.notice()` and returns the existing URL via output. Re-running `workflow_dispatch` is therefore a no-op.
- Permissions: `contents: read`, `discussions: write` — both granted by `GITHUB_TOKEN` defaults once Discussions is enabled on the repo.
## 💖 Donate page
- New `web/src/pages/Donate.tsx` route at `/donate` — grid of 5 platform cards (GitHub Sponsors, Ko-fi, Buy Me a Coffee, Patreon, PayPal) sourced from `.github/FUNDING.yml`.
- Each card has a tinted icon ring, label, short description, and an "Open" button (`target="_blank" rel="noopener noreferrer"`).
- New nav item in `web/src/components/layout/Sidebar.tsx` SECONDARY group (between About and Settings); `Heart` icon from lucide.
- Full EN + VI i18n keys under `donate.*` (title / subtitle / cta / footnote + per-platform label & desc).
## 📖 Dev docs
- New `docs/pc_spec.md` (EN) + `docs/i18n/vi/pc_spec.md` (VI) — maintainer hardware spec mirroring `E:\spec.txt` (CPU / GPU / RAM / IDE) plus iPhone test-device list.
- New `docs/dev_env.md` (EN) + `docs/i18n/vi/dev_env.md` (VI) — IDE map (PyCharm / WebStorm / RustRover 2026.x), toolchain table (Python 3.12 / Node ≥ 22 / Rust stable / Tauri 2), per-area dev workflow (web / Tauri / Python pipeline), Git + GPG conventions, branch + PR flow.
- New `web/src-tauri/TAURI.md` — desktop build prerequisites (incl. CI's exact `apt-get` line), local + production build commands, signing + auto-update notes, troubleshooting.
- `AUTHORS.md` — new "Dev info" table (GitHub handle, IDE channel, toolchain versions, link map to all the above).
- README "Docs" section — links the four new docs.
## 🤖 Telegram bot user-guide pointer
- New `docs/telegram-bot.md` — one-page pointer to the external [`telegram-scraper-bot/docs/USER_GUIDE.md`](https://github.com/poli0981/telegram-scraper-bot/blob/main/docs/USER_GUIDE.md), bot source repo, plus a paragraph each on what the bot does and the whitelist lifecycle.
- `CONTRIBUTING.md` — section 3 (`@my_skull_bot`) gets a 3-line callout with the user guide link, bot source URL, and the new in-repo summary doc.
- `web/src/pages/About.tsx` — Maintainer card's privacy note now includes a "Bot user guide & source" sub-card with the same three links.
## 🩺 Health bucket split
- `web/src/pages/Health.tsx` — `gatherIssues()` adds a fifth `IssueGroup`: `OnlineAcUnknown` for games with `type_game === "online"` and `anti_cheat ∈ {"", "-"}`. Previously these games were silently dropped from all categories; now they have a discoverable home.
- Edge-case fix: the existing "Kernel" filter compared `(r.anti_cheat ?? "-") !== "-"`, missing the empty-string case. Both filters now use a normalised `(r.anti_cheat ?? "").trim()`.
- `ShieldQuestion` icon (lucide). EN + VI i18n keys: `health.groupOnlineAcUnknown` + `…Desc`.
## 🎮 Steam Desktop direct link
- New helper `web/src/lib/steam-link.ts` — `steamProtocolUrl(appid)` returns `steam://store/<appid>`, `steamWebUrl(appid)` returns the regular HTTPS store URL.
- `web/src/components/games/GameDetailDrawer.tsx` — single store link replaced by two buttons rendered side-by-side: a primary "Steam Desktop" (`steam://`) and an outline "Web" (`https://`). Tooltip on the desktop button explains the fallback path.
- Works in both web build (browser shows protocol prompt if Steam is installed, silent fail otherwise — Web button is the safety net) and Tauri build (Tauri 2 allows `steam://` navigation by default; no allow-list change needed).
- EN + VI i18n: `detail.openOnSteamDesktop`, `detail.openOnSteamDesktopHint`, `detail.openOnSteamWeb`.
## 🛌 Bi-weekly offline-player leaderboard
- New `scripts/top_offline.py` — clones the `top_online.py` shape but filters `_is_offline(g)` (non-empty `type_game ≠ "online"`). Emits `games/top-offline.md` (top 100 single-player F2P concurrents, 10-column format identical to top-online).
- Calibrated tier thresholds (`_TIERS`) lower than online (offline games rarely break 6-figure concurrents) — `🔥 Mega ≥ 20k`, `⭐ Hot ≥ 5k`, `🟢 Healthy ≥ 1.5k`, `🟡 Stable ≥ 300`, `🟠 Low ≥ 50`, `🔴 Quiet ≥ 10`, `💀 Idle <10`.
- New `bash/offline.sh` matches the shape of `bash/online.sh` (pip install requests → run script → conditional commit).
- New `.github/workflows/top-offline.yml` — cron `0 5 1,15 * *` (1st + 15th of each month at 05:00 UTC) plus `workflow_dispatch`. Shares the unified `data-write` concurrency group.
- Health page (`web/src/pages/Health.tsx`) — new manual trigger button "Top offline" (next to the existing "Top online" trigger).
- **Bug fix during implementation**: `scripts/core/fetcher.py:update_players_only()` had a hardcoded `type_game == "online"` filter that would have made the offline workflow refresh zero rows. Extended with a `type_filter` kwarg (`"online"` default for backward compat, `"offline"`, or `"all"`); `top_offline.py` passes `type_filter="offline"` (excludes both online and empty/unclassified type).
## 🔢 Versioning
| Surface | Old | New |
|---|---|---|
| Repo public-facing | 3.1.0 | **3.2.0** |
| `web/package.json` | 1.1.0 | **1.2.0** |
| `web/src-tauri/Cargo.toml` | 1.1.0 | **1.2.0** |
| `web/src-tauri/tauri.conf.json` | 1.1.0 | **1.2.0** |
| Git tag (signed) | `v3.1.0` | `v3.2.0` |
| Desktop tag (signed) | `desktop-v1.1.0` | `desktop-v1.2.0` |
+20
View File
@@ -0,0 +1,20 @@
# v3.2.1 – 2026-05-11 (The "Genre Cleanup" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.0. Normalizes inconsistent `genre` values across the dataset (31 records, 10 canonical mappings) and broadens the webapp's genre combobox with 14 additional suggestions. Web app + desktop bumped `1.2.0` → `1.2.1`. Repo public-facing version `3.2.0` → `3.2.1`. Tag `v3.2.1` is GPG-signed; companion desktop tag is `desktop-v1.2.1`.
## 🧹 Genre normalization script
- New `scripts/normalize_genres.py` — local one-shot tool with `--apply` flag (dry-run by default). Reuses `core.data_store.load_main` / `save_main` so writes are atomic + sharded.
- Canonical mappings applied (sentence-case style for compounds): `Hack and Slash` → `Hack & Slash` (4), `Third-Person Shooter` → `Third-person Shooter` (7), `Top-Down Shooter` → `Top-down Shooter` (3), `Turn-Based Strategy` → `Turn-based Strategy` (3), `Turn-Based Tactics` → `Turn-based Tactics` (4), `Turn-Based Combat` → `Turn-based Combat` (2), `Shoot 'Em Up` / `Shoot'em up` → `Shoot 'em up` (5), `Point-and-Click` → `Point & Click` (1), `Rougelite` → `Roguelite` (2 typo).
- 31 records updated · 10 unique canonical changes · unique-genre count 100 → 92.
- Idempotent — second run reports "data already canonical".
- Comma-separated values like `"Action RPG, Gacha"` (Wuthering Waves, Honkai Impact 3rd) are flagged in a "Manual review needed" section rather than auto-split, since the schema is single-genre.
- All `games/*.md` regenerated via `scripts/generate_tables.py`; affected genre files include the new sentence-case slugs (`turn-based-strategy.md`, `top-down-shooter.md`, `third-person-shooter.md`, `roguelite.md`, etc.).
## 🎛 Webapp genre dropdown additions
- `web/src/lib/enums.ts` — `GENRE_ENUM` extended from 44 → 58 entries. Added 14 sub-genres already common in the data: `Action RPG`, `Beat 'em up`, `Bullet Hell`, `Clicker`, `Hidden Object`, `Real-Time Strategy`, `Roguelite`, `Survival Horror`, `Tactical RPG`, `Third-person Shooter`, `Top-down Shooter`, `Turn-based RPG`, `Turn-based Strategy`, `Turn-based Tactics`.
- Sentence-case style matches the normalized data values.
- Dropdown filter on `web/src/pages/Games.tsx` is facet-driven (auto-updates from the records), so it now shows the deduplicated canonical names. The `EditGameDrawer` combobox suggests the 14 new entries while still accepting free-text input.
+28
View File
@@ -0,0 +1,28 @@
# v3.2.2 – 2026-05-11 (The "Bug Fix Quartet" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.1. Four user-reported bug fixes touching the Ctrl+K command palette on desktop, the Health → Games navigation flow, Tauri process-stacking on every launch, and the `type_game` scraper that was defaulting every new game to `"offline"`. Web app + desktop bumped `1.2.1` → `1.2.2`. Repo public-facing version `3.2.1` → `3.2.2`. Tag `v3.2.2` is GPG-signed; companion desktop tag is `desktop-v1.2.2`.
## 🔗 Desktop Ctrl+K external link
- New `web/src/lib/external-open.ts` — lazy-detects the Tauri runtime via `__TAURI_INTERNALS__`, opens external URLs through `@tauri-apps/plugin-shell` on desktop (capability `shell:allow-open` already granted in `web/src-tauri/capabilities/default.json`), falls back to `window.open(url, "_blank", "noopener,noreferrer")` on web/PWA. Plugin module is lazy-imported, so the web bundle never pays for the Tauri code path.
- `web/src/components/common/CommandPalette.tsx` — Ctrl+K game results now route through `openExternal()`. The Tauri webview was silently blocking the raw `window.open(r.link, "_blank")` for external HTTPS URLs, so clicking a search result on desktop did nothing.
- Six other `window.open(...)` call sites (Health workflow link, Add, BulkActionBar, BulkEditDrawer, EditGameDrawer, DeviceFlowPanel) are flagged for follow-up migration to `openExternal()` — same desktop silent-fail will hit them when triggered.
## 🩺 Health → Games filter restoration
- `web/src/pages/Games.tsx` — adds `useSearchParams` + a `useEffect` that mirrors the URL `?search=` parameter into `useFilters.search` on mount. The Health page already linked rows to `#/games?search=<name>`, but Games never read the param, so the table stayed unfiltered and the Topbar input stayed empty. The store binding to Topbar means visual feedback is automatic once the filter is set.
- Guard `if (term !== null)` (instead of `if (term)`) lets `?search=` explicitly clear the filter — useful for shareable "no filter" links.
## 🪟 Tauri single-instance enforcement
- `web/src-tauri/Cargo.toml` — adds `tauri-plugin-single-instance = "2"` under the existing desktop-only `cfg(not(any(target_os = "android", target_os = "ios")))` block, matching the updater plugin's gating pattern.
- `web/src-tauri/src/lib.rs` — registers single-instance as the **first** plugin so it short-circuits duplicate launches before any other state initialises. The dup-launch callback calls `unminimize()` + `show()` + `set_focus()` on the existing `main` window. Without this, every Start-menu / shortcut / file-association invocation spawned a fresh `f2p-tracker.exe` that lingered in Task Manager.
- No capability changes needed — plugin runs entirely Rust-side, no frontend command exposed.
## 🎮 `type_game` online inference
- `scripts/core/fetcher.py` — new `_infer_type_game(categories)` reads `data.get("categories", [])` and returns `"online"` when any description contains `online`, `mmo`, `massively multiplayer`, `cross-platform multiplayer`, or `multi-player`. Pure `shared/split screen` descriptions are treated as local-only and skipped unless paired with another online signal.
- Wired into `apply_details()` next to the existing anti-cheat category loop, guarded by `is_empty(game.get("type_game"))` so manual prefills in `temp_info.jsonl` remain authoritative — the `MANUAL_FIELDS` merge in `data_store.merge_extension_data()` and the override re-apply in `ingest_new.py` are unchanged.
- The legacy default-to-`"offline"` at the end of `fetch_full()` stays as the final safety net for games with no multiplayer signal in Steam categories. New ingests of online F2P games now classify correctly instead of all-offline.
+26
View File
@@ -0,0 +1,26 @@
# v3.2.3 – 2026-05-17 (The "View Commit Toast + Offline AC Lock" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.2. Three user-reported fixes: the "View commit" action button in success toasts (now reachable + cross-platform), an editor lock that prevents anti-cheat fields from being set on offline games, and a broken `Mark dead games` workflow setup-python step. Web app + desktop bumped `1.2.2` → `1.2.3`. Repo public-facing version `3.2.2` → `3.2.3`. Tag `v3.2.3` is GPG-signed; companion desktop tag is `desktop-v1.2.3`.
## 🍞 View commit toast — clickable + desktop-safe
- Migrated the eight `window.open(commit.htmlUrl, "_blank")` action handlers in `EditGameDrawer.tsx` (2), `Add.tsx` (2 inside `reportToast`), `BulkEditDrawer.tsx` (2), and `BulkActionBar.tsx` (2) to `openExternal()` from `web/src/lib/external-open.ts` — completes the follow-up migration flagged in v3.2.2's CHANGELOG. The Tauri webview was silently blocking the raw `window.open(...)` for external HTTPS URLs, so "View commit" did nothing on desktop.
- Each `toast.success(...)` with a "View commit" action now sets `duration: 15000` (was Sonner's 4 s default). On web the old toasts auto-dismissed before the user could read the description + click the action button.
- Handler now accepts the click event and calls `event.preventDefault()` so the toast stays visible after click (Sonner's default is to dismiss on action click — undesirable when the user wants to glance at the SHA after opening the commit).
- The fix applies to both the initial `toast.success` and the follow-up emit fired by `pollCommitVerification(...).then(...)` (same toast `id`, so `duration` must be set on the update too — otherwise the second emit rebounds to the 4 s default).
## 🔒 Anti-cheat fields lock on offline games
- `web/src/components/games/EditGameDrawer.tsx` — `FormFields` derives `lockAC = form.type_game === "offline"` and threads `disabled={lockAC}` to the AC `<select>`, the custom-AC `<Input>`, the three kernel `<Button>`s, and the AC note `<Textarea>`. A muted hint is rendered under the AC note when locked, explaining how to re-enable.
- `update()` setter now auto-resets `anti_cheat=""`, `anti_cheat_note=""`, `is_kernel_ac="unknown"` when `key === "type_game" && value === "offline"`. This keeps the `formToPatch()` diff honest — switching an online game with AC populated to offline now produces an explicit AC-clear in the commit instead of orphan anti-cheat data on an offline record.
- `web/src/pages/Add.tsx` — same pattern in `OverrideFields` + the `SingleAdd.setOv()` setter. `OverrideFields` combines the existing busy-state `disabled` prop with the new lock via `acDisabled = disabled || lockAC`, so the global "form is submitting" disable still wins. BulkAdd uses raw text / JSON input, so no UI lock needed there.
- `type_game === ""` (unknown) deliberately does **not** lock — only an explicit `"offline"` triggers the gate. The existing `validation.ts` "kernel?" badge rule for online + missing-kernel is untouched.
- New i18n key `edit.acLockedOffline` added to `web/src/i18n/locales/en.json` and `vi.json`, rendered as a `text-xs text-muted-foreground` hint under the AC note when `lockAC` is true.
## 🪦 `Mark dead games` workflow path fix
- `.github/workflows/mark-dead-games.yml` — `cache-dependency-path: scripts/requirements.txt` and the subsequent `pip install -r scripts/requirements.txt` both pointed at a path that doesn't exist. The file lives at the repo root (`requirements.txt`), consistent with the path `codeql.yml:25` already uses.
- Fix: both lines now reference `requirements.txt` at the root. The `setup-python` cache lookup no longer errors with `No file in /home/runner/work/free-steam-games-list/free-steam-games-list matched to [scripts/requirements.txt or **/pyproject.toml]`, and the install step actually finds the deps.
- Workflow is scheduled Mon + Thu 04:30 UTC; the next scheduled run will be the first end-to-end verification, but `workflow_dispatch` with `dry_run=true` is also available for ad-hoc validation.
+63
View File
@@ -0,0 +1,63 @@
# v3.2.4 – 2026-05-20 (The "Refactor + Removed-Games + Anti-Cheat Index" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.3, landed as two PRs. **PR #74 (cleanup):** two dead scripts removed, `EditGameDrawer.tsx` (718 LOC) and `GamesTable.tsx` (568 LOC) split into focused sub-modules, two new charts (`TopOfflineBar`, `AddedPerMonthBar`) wired to a fresh `/top-offline` page and the existing `/charts/time` page. **PR #75 (features):** the `scripts/removed_games.jsonl` log now passes through a `dedup_removed()` filter on every write (a one-time migration trimmed 6 historical duplicates), Top Online leaderboard expanded `50 → 100` to match Top Offline, a generated `games/anti-cheat-list.md` plus a `/charts/anti-cheat/list` web page group active games by anti-cheat family, and a new `/charts/delisted` page renders a timeline + reason breakdown of every removed-from-catalogue title. Web app + desktop bumped `1.2.3` → `1.2.4`. Repo public-facing version `3.2.3` → `3.2.4`. Tag `v3.2.4` is GPG-signed; companion desktop tag is `desktop-v1.2.4`.
## 🧹 Dead-script removal
- `scripts/discord_notify.py` deleted — superseded by the `poli0981/.github` reusable workflow; no `.github/workflows/*.yml` or `bash/*.sh` referenced it.
- `scripts/migrate_to_shards.py` deleted — one-shot v2.2 migration tool, completed and unreferenced. The 10-script "unreferenced in workflows" audit confirmed the other eight (`check_dead_links`, `delete_game`, `normalize_genres`, `purge_unhealthy`, `top_offline`, `top_online`, `update_data`, `update_reviews`) all have live `bash/*.sh` wrappers and stay.
## 🪓 Component splits
- `web/src/components/games/EditGameDrawer.tsx` (718 LOC) → 7 focused files under `edit/`:
- `EditGameDrawer.tsx` keeps the save handler, dialog shell, view-toggle wiring.
- `EditFormFields.tsx`, `EditJsonView.tsx` (with `JsonDiff`), `EditChangePreview.tsx`, `ViewToggle.tsx` extract the four UI regions.
- `form-utils.ts` exports `gameToForm` + `formToPatch`; `types.ts` re-exports the `FormState` + `View` types.
- `web/src/components/games/GamesTable.tsx` (568 LOC) → container + 5 files under `table/`:
- `GamesTable.tsx` keeps the virtualizer (`useVirtualizer` ownership at container level so row-height stays single-source), filters, fuzzy search, sort, and paging.
- `columns.tsx` extracts the `COLS: ColDef[]` array (12 columns) + `TOTAL_WIDTH` + `SELECT_COL_WIDTH` constants.
- `TableHeader.tsx`, `TableRow.tsx` (memoised with `React.memo`), `TableToolbar.tsx`, `ExportMenu.tsx` extract the visual regions.
- No behaviour change — same virtual scrolling, same sort/filter wiring, same selection store.
## 📊 New charts
- `web/src/components/charts/TopOfflineBar.tsx` — mirror of `TopOnlineBar` but with offline-tier thresholds (20k/1.5k/300) calibrated to the `top_offline.py` scale instead of the online-only 100k/10k/1k palette. Filters `type_game !== "online" && status === "active"`, top 100 by `current_players`.
- `web/src/pages/TopOffline.tsx` — new page at `/top-offline`, layout mirror of `TopOnlinePage`, registered in `App.tsx` and `Sidebar.tsx` (Trophy icon).
- `web/src/components/charts/AddedPerMonthBar.tsx` — aggregates `records[*].added_at` into `YYYY-MM` buckets, renders an ECharts bar. Added as a third card to the existing `charts/Time.tsx` page alongside `ReleaseYearHistogram` + `AddedCumulativeLine`.
## 🗑️ Removed-games dedup
- `scripts/core/data_store.py` — new `dedup_removed(records)` keeps the latest entry per appid (compared by `removed_at` ISO timestamp, lexicographic order matches chronological for `YYYY-MM-DDTHH:MM:SSZ`). Records without a resolvable appid are dropped.
- `scripts/purge_unhealthy.py:41-43` and `scripts/ingest_new.py:106-108` — both call sites now write `dedup_removed(existing + log)` instead of `existing.extend(log)`. Same `save_jsonl` atomic-rename transaction, so partial writes can't leave duplicates.
- `scripts/dedup_removed_games.py` (new) — one-shot CLI that loads, dedups, and rewrites the file. Run once locally as part of this release; idempotent, safe to re-run.
- Result: existing log trimmed `43 → 37` records. Verified zero duplicate appids post-migration.
## 🏆 Top Online expanded 50 → 100
- `scripts/core/constants.py:81` — `TOP_ONLINE_LIMIT = 100` (was 50). Top Offline already 100.
- `games/top-online.md` regenerated with 100 rows on next workflow tick; format unchanged (10-column table preserved).
- `web/src/pages/TopOnline.tsx` — `<TopOnlineBar limit={100} height={1800}>` to match the new row count.
- i18n strings `topOnline.{subtitle,cardTitle}` updated `Top 50 → Top 100` in both `en.json` and `vi.json`.
## 🛡️ Anti-cheat list
- `scripts/generate_anti_cheat_list.py` (new) — buckets active games by canonical AC name (`ANTI_CHEAT_PATTERNS` keys), with substring-match fallback for free-text values. Unrecognised values land in an `Other` bucket with a stderr warning. Output `games/anti-cheat-list.md`: H1 + TOC + per-family H2 sections, each a 6-column table sorted by `current_players` desc.
- `bash/anti_cheat.sh` + `.github/workflows/anti-cheat-list.yml` (new) — weekly Sunday 06:00 UTC cron + manual dispatch. Uses the same `data-write` concurrency group as the other table-generation workflows.
- `web/src/pages/AntiCheatList.tsx` (new) — `/charts/anti-cheat/list` page mirrors the MD: collapsible per-family sections + sticky AC-name sidebar nav. Uses existing `useGames` hook; canonicalises client-side via a TS port of the Python patterns table. i18n keys `antiCheatList.*` added to en + vi.
## 📉 Delisted charts
- `web/src/hooks/useRemovedGames.ts` (new) — fetches `scripts/removed_games.jsonl` from raw.githubusercontent.com, parses lines, deduplicates client-side (same logic as the Python dedup). TanStack Query with 5-minute staleTime.
- `web/src/components/charts/DelistedTimeline.tsx` (new) — ECharts stacked bar, x = `YYYY-MM` of `removed_at`, stacked by `status_code` (`not_free` / `unavailable` / fallback `other`).
- `web/src/components/charts/DelistedReasonBreakdown.tsx` (new) — ECharts donut by `status_code`.
- `web/src/pages/charts/Delisted.tsx` (new) — `/charts/delisted` page renders both charts. Sidebar nav link with `WifiOff` icon.
- `web/src/components/charts/KpiCards.tsx` — new optional `removedCount` prop; when set, renders a 7th "Removed (all-time)" KPI alongside the existing in-catalog "Delisted" badge. Wired from `Dashboard.tsx` via `useRemovedGames().data?.length`. Grid bumps from `xl:grid-cols-6` to `xl:grid-cols-7`.
## 📝 Docs
- README: removed the duplicate "Quick Links" section (the comprehensive 11-row "Quick links" table at the top covers everything the 4-row duplicate listed).
- README: added `🎯 Top offline (md)` row to the main Quick links table.
- README: version badge bumped `3.2.3` → `3.2.4`.
- i18n: combined `nav.{topOffline,antiCheatList,delisted}`, `topOffline.*`, `antiCheatList.*`, `charts.{time.addedPerMonth,delisted.*}` keys added to `en.json` + `vi.json`.
+30
View File
@@ -0,0 +1,30 @@
# v3.2.5 – 2026-05-20 (The "AC Nav + Mobile + Games Cleanup" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.4. One reported bug fix + three quality-of-life polish items. **Bug:** clicking any "Family" link in the Anti-Cheat Index sidebar redirected to the Dashboard instead of scrolling to the matching family table — `HashRouter` was treating the `<a href="#vac">` anchor as a route navigation. **Polish:** the `GamesTable` (1318 px wide) now degrades to a virtualised card list below the `md` breakpoint so mobile no longer needs horizontal scroll; the `AntiCheatList` sidebar drops to `md` instead of `lg` and exposes a horizontal chip nav on phones; `KpiCards` adds `md`/`lg` rungs to avoid uneven grid jumps. **Cleanup:** 93 per-genre markdown files in `games/` are removed (the web app's `/games?genre=X` filter has replaced them since v3.0); `generate_tables.py` now skips regeneration when game data hasn't actually changed via a `.gen-hash` checksum, cutting daily catalogue commits to roughly the days that move records. **New:** floating back-to-top button on the main scroll container, fades in past 400 px. Web app + desktop bumped `1.2.4` → `1.2.5`. Repo public-facing version `3.2.4` → `3.2.5`. Tag `v3.2.5` is GPG-signed; companion desktop tag is `desktop-v1.2.5`.
## 🔗 AC Index sidebar navigation fix
- [web/src/pages/AntiCheatList.tsx](../../../web/src/pages/AntiCheatList.tsx): swap `<a href="#anchor">` for `<button onClick>` that calls `document.getElementById(id).scrollIntoView({ behavior: "smooth", block: "start" })`. The `id={anchor}` attribute on each family `<Card>` stays the same — only the click target changes.
- Root cause: `main.tsx:24` uses `HashRouter`. Anchor links inside a hash-routed page produce URLs like `#/charts/anti-cheat/list#vac`. HashRouter parses the trailing `#vac` as a fresh route, the regex doesn't match, and the `<Route path="*" element={<Navigate to="/" replace />}>` fallback in `App.tsx` sends the user to the Dashboard.
- Same fix applied to the new mobile chip nav (below) so behaviour is uniform across viewports.
## 📱 Mobile responsive
- New `web/src/components/games/table/MobileGameCards.tsx` — virtualised card list rendering one card per game with thumb, name, genre/type/AC/status badges, review %, current players, and a Steam-link icon. Shares filter/sort/page state with the desktop table via the existing `useFilters` store.
- [`GamesTable.tsx`](../../../web/src/components/games/GamesTable.tsx) wraps the desktop scroll container in `hidden md:block` and renders `<MobileGameCards>` inside `md:hidden`. No new state, no behaviour drift between views.
- [`AntiCheatList.tsx`](../../../web/src/pages/AntiCheatList.tsx) sidebar changes from `hidden w-48 shrink-0 lg:block` to `hidden md:block md:w-40 lg:w-48` — visible on tablets too. Below `md`, a horizontal scrollable chip rail above the content provides the same family-jump nav.
- [`KpiCards.tsx`](../../../web/src/components/charts/KpiCards.tsx) grid `sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-7` → `sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-7`. Inserts `md` (tablet, 3 cols) and `lg` (small laptop, 4 cols) rungs so the 7 KPIs don't double-stack awkwardly.
## 🧹 `games/` cleanup + smart regen
- **Deleted 93 per-genre `<genre>.md` files** (`action.md`, `fps.md`, `visual-novel.md`, …). Web app `/games?genre=X` is the canonical genre filter since v3.0; no inbound link audit hit anything beyond `games/README.md` (regenerated) and the now-stale "By Genre" section in the index. Files kept: 11 × `all-games_part*.md`, `top-online.md`, `top-offline.md`, `anti-cheat-list.md`, `README.md`.
- [`scripts/generate_tables.py`](../../../scripts/generate_tables.py) drops the genre loop entirely and rewrites the `games/README.md` template to point at part files + leaderboards + AC list, with a one-line note about the web-app genre filter.
- **Smart regen via `.gen-hash`** — script computes `sha256` of sorted `(link, name, genre, reviews, current_players, anti_cheat, is_kernel_ac, status)` tuples and writes the digest to `games/.gen-hash`. Subsequent runs short-circuit (`Skip: no semantic changes (hash=...)`) when the hash is unchanged. Order-invariant, ignores timestamps embedded in MD output, so daily workflow ticks only commit when game data actually moves.
## ⬆️ Back-to-top button
- New `web/src/components/common/BackToTop.tsx` — a fixed-position icon button bottom-right of the viewport. Listens for `scroll` events on the passed scroll container ref (passive listener), fades in (`opacity-100`) past 400 px, becomes pointer-events-none below to avoid blocking click-through.
- [`Layout.tsx`](../../../web/src/components/layout/Layout.tsx) creates a `useRef<HTMLElement>` on `<main>`, passes it as `scrollRef`. Single mount, no per-page wiring.
- i18n: `common.backToTop` added to `en.json` ("Back to top") and `vi.json` ("Lên đầu trang") for `aria-label` + `title`.
+16
View File
@@ -0,0 +1,16 @@
# v3.2.6 – 2026-05-20 (The "Mobile Hotfix" Edition)
[All versions](../../../CHANGELOG.md)
Hotfix on top of v3.2.5. Two mobile-viewport regressions introduced by the v3.2.5 responsive overhaul. Web app + desktop bumped `1.2.5` → `1.2.6`. Repo public-facing version `3.2.5` → `3.2.6`. Tag `v3.2.6` is GPG-signed; companion desktop tag is `desktop-v1.2.6`.
## 🐛 AC Index table — horizontal scroll on mobile
- `web/src/pages/AntiCheatList.tsx` — the per-family table wrapper was `<div className="overflow-hidden rounded-md border">`. On a 390 px viewport the 5-column table (`# / Game / Genre / Kernel / Players`) is wider than the card, and `overflow-hidden` clipped the right-hand columns with no way to scroll to them.
- Fix: `overflow-hidden` → `overflow-x-auto`. The table now scrolls horizontally when it exceeds the viewport, and the scrollbar stays hidden when it fits.
## 🖼️ Mobile game cards — thumbnail fallback
- `web/src/components/games/table/MobileGameCards.tsx` — the card `<img>` loads `headerToCapsule(g.header_image)` (the smaller `capsule_184x69.jpg` variant, ~10 KB vs ~50 KB). Steam's CDN doesn't host that variant for every game, so those cards rendered a blank thumbnail.
- The desktop table column (`table/columns.tsx`) already had an `onError` handler that falls back to the original `header.jpg`; the v3.2.5 mobile card component didn't port it. `GameDetailDrawer` uses `g.header_image` directly, which is why the image always appeared once a card was tapped.
- Fix: add the same `onError` fallback to the mobile card `<img>` — on a 404 it swaps `src` to `g.header_image`, with an `el.src !== g.header_image` guard against an infinite error loop.
+35
View File
@@ -0,0 +1,35 @@
# v3.2.7 – 2026-05-22 (The "Coming-Soon Guard + Dead-Code Cleanup" Edition)
[All versions](../../../CHANGELOG.md)
Maintenance release on top of v3.2.6. A small, useful batch: the Python pipeline now rejects unreleased ("coming soon") games at ingest instead of listing titles nobody can play yet; a one-time dead-code sweep across the web app and the pipeline; and three dev-tooling additions (knip, vulture, pip-audit) so future releases can run the same checks. Web app + desktop bumped `1.2.6` → `1.2.7`. Repo public-facing version `3.2.6` → `3.2.7`. Tag `v3.2.7` is GPG-signed; companion desktop tag is `desktop-v1.2.7`.
## 🚧 Coming-soon games rejected at ingest
- `scripts/core/health_checker.py` — new `COMING_SOON` status, added to the `REMOVABLE` set. `check_game_health()` now reads the Steam `appdetails` flag `release_date.coming_soon` right after the API response resolves (before the `is_free` check) and returns `HealthResult(COMING_SOON, …)` for unreleased titles.
- Effect: `ingest_new.py` rejects coming-soon entries from the queue and logs them to `removed_games.jsonl` with reason "Not yet released (coming soon)" — the same path `NOT_FREE` already uses. `purge_unhealthy.py`'s weekly scan likewise evicts any coming-soon title already in the dataset.
- Rationale: an F2P *games* tracker should list playable titles. A coming-soon game has zero players, no reviews, and an unconfirmed price (it can launch paid). The API flag is used instead of scraping the `game_area_comingsoon` HTML block — it's already fetched during the health check and is authoritative. No schema change.
## 🧹 Web dead-code cleanup (knip)
- New `knip` sweep (config in `web/knip.json`). Removed two unused files: `src/components/common/UpdateChecker.tsx` — the Tauri auto-update component, never wired into `Layout.tsx` since Phase 9, so the frontend update check never actually ran — and `src/components/ui/switch.tsx`, an unused shadcn primitive.
- Removed 11 unused dependencies from `web/package.json`: 7 Radix primitives (`react-dropdown-menu`, `react-scroll-area`, `react-select`, `react-switch`, `react-tabs`, `react-toast`, `react-tooltip`), `@tanstack/react-table` (the virtualised table uses only `@tanstack/react-virtual`), and 3 Tauri packages (`@tauri-apps/api`, `@tauri-apps/plugin-process`, `@tauri-apps/plugin-updater` — the last two were referenced only by the removed `UpdateChecker`).
- `vite.config.ts` — dropped the now-stale `@tanstack/react-table` entry from the `manualChunks.table` group.
- knip's remaining "unused export" findings inside the `src/lib/*` port modules are intentional API surface; they're set to `warn` so `npm run knip` stays green.
## 🧹 Python dead-code cleanup (vulture)
- Deleted `scripts/dedup_removed_games.py` — the one-shot v3.2.4 migration, completed and now redundant (`dedup_removed()` runs inside the pipeline on every write). Same rationale as v3.2.4's removal of `migrate_to_shards.py`.
- `scripts/core/data_store.py` — dropped the unused `EXTENSION_FIELDS` import. The constant stays defined in `constants.py` as the documented MANUAL/ARRAY/EXTENSION field-class trio (mirrored in `web/src/lib/schema.ts`).
- `scripts/core/steam_client.py` — `__exit__(self, *a)` → `__exit__(self, *_)` (idiomatic unused-varargs name).
## 🧰 Dead-code & audit tooling
- **knip** — `web/package.json` devDependency + `npm run knip` script + `web/knip.json`. Finds unused files / exports / dependencies in the TypeScript SPA.
- **vulture** + **pip-audit** — new `requirements-dev.txt`; vulture config in a new root `pyproject.toml` (`[tool.vulture]`, `min_confidence = 80`). Python dead-code detection + dependency CVE audit.
- All three run at dev time only — nothing new ships in the pipeline, web bundle, or desktop app.
## 📄 Docs
- New `docs/THIRD_PARTY.md` — documents the dev tooling above (purpose, license, where declared) and the canonical pre-publish check suite. Linked from the README "Docs" section.
- Synced the third-party dependency lists to the removals above — `docs/ACKNOWLEDGEMENTs.md`, the in-app `/about` page (`web/src/pages/About.tsx`), and `web/README.md` no longer list the dropped Radix primitives, `@tanstack/react-table`, or `@tauri-apps/api`.
+46
View File
@@ -0,0 +1,46 @@
# v3.3.0 – 2026-06-12 (The "Lazy-Load + Error Pages" Edition)
[All versions](../../../CHANGELOG.md)
Feature release on top of v3.2.7, two themes: a web-app performance overhaul (route-level code splitting, lazy echarts/openpgp/locale chunks — first-load JS drops from ~574 KB to ~163 KB gzipped, −72%) and a proper error-page system (403/404/419/5xx/offline pages, React error boundaries, a real GitHub Pages `404.html`). Web app + desktop bumped `1.2.7` → `1.3.0`. Repo public-facing version `3.2.7` → `3.3.0`. Tag `v3.3.0` is GPG-signed; companion desktop tag is `desktop-v1.3.0`.
## ⚡ Lazy-loading overhaul
- **Route splitting** — [web/src/App.tsx](../../../web/src/App.tsx): every page except `Dashboard` (the landing route) is now `React.lazy` via a new `lazyWithRetry` helper ([web/src/lib/lazy.ts](../../../web/src/lib/lazy.ts)). The `<Suspense>` boundary sits inside [Layout.tsx](../../../web/src/components/layout/Layout.tsx) around `<Outlet/>`, so the sidebar/topbar stay mounted during navigation; fallback reuses the existing `LoadingState`.
- **echarts (~666 KB raw)** — new [LazyEChart.tsx](../../../web/src/components/charts/LazyEChart.tsx) wrapper is the single dynamic boundary for `EChart.tsx` (which keeps the `echarts.use([...])` registration). All 15 chart components swap one import line; a fixed-height `animate-pulse` skeleton prevents layout shift. echarts now downloads only when a chart mounts.
- **openpgp (~391 KB raw)** — [web/src/lib/gpg.ts](../../../web/src/lib/gpg.ts) switches to a type-only import + memoized `await import("openpgp")`. All exports were already async, so zero caller changes; visitors without a saved GPG key never download the crypto chunk at all.
- **Per-locale i18n** — [web/src/i18n/index.ts](../../../web/src/i18n/index.ts): `en.json` stays bundled (it's `fallbackLng` — a missing key can never render raw), `vi.json` becomes a dynamic import. `initI18n()` preloads the detected locale before `i18n.init`, and [main.tsx](../../../web/src/main.tsx) awaits it before first render — no flash of raw keys, verified with a hard reload under `f2p:lang=vi`. `setLanguage()` is now async and loads the bundle *before* switching. Also syncs `<html lang>` (was hardcoded `vi` for everyone).
- **manualChunks fix** — forcing `echarts`/`openpgp` into `manualChunks` made Rollup hoist shared helpers (tslib) *into* the echarts chunk, which the eager graph then statically imported — echarts was being modulepreloaded on first paint, nullifying the lazy boundary. Both entries are removed from [vite.config.ts](../../../web/vite.config.ts); the dynamic-import boundaries split them naturally. `dist/index.html` now modulepreloads only `react` + `query`.
- Net effect: eager JS `~1746 KB → ~494 KB` raw (`~574 → ~163 KB` gzip). The PWA still precaches everything in the background, but first paint no longer waits for charts + crypto.
## 🚦 Error pages (403 / 404 / 419 / 500 / 502 / 503 / 504 / offline)
- New [web/src/pages/errors/ErrorPage.tsx](../../../web/src/pages/errors/ErrorPage.tsx) — one config-driven component: per-code lucide icon + tone (neutral/warn/destructive, reusing the exact `ErrorState`/`PwaIndicator` palettes), mono `ERROR {{code}}` badge, i18n'd title/description, and three actions (Go home / Reload / Report issue → GitHub Issues). Full `errors.*` key blocks added to both [en.json](../../../web/src/i18n/locales/en.json) and [vi.json](../../../web/src/i18n/locales/vi.json). Kept in the eager bundle on purpose — error UI must not live in a lazy chunk.
- Routing — `#/error/:code` deep links via `ErrorCodeRoute` (unknown codes render 404 in place, no redirect), and the catch-all `<Route path="*">` now shows a real 404 page instead of silently redirecting to the Dashboard.
- **GitHub Pages `404.html`** — new [web/public/404.html](../../../web/public/404.html): standalone dark page (inline CSS, no JS deps), bilingual via a one-liner that respects the app's own `f2p:lang`, `noindex`, absolute link back to `/free-steam-games-list/#/`. Excluded from the SW precache via `globIgnores` in [vite.config.ts](../../../web/vite.config.ts) — SW-controlled clients get `navigateFallback` and never see it.
## 🛡️ Error boundaries + stale-deploy resilience
- New [ErrorBoundary.tsx](../../../web/src/components/common/ErrorBoundary.tsx) (own ~40-line class, no new dep) with a `resetKey` prop — navigating away clears a stuck error *without* remounting the page subtree on every navigation (which `key` would do, destroying table scroll/selection state).
- Two mounts: route-level inside `Layout` (chunk-load error → 503 page with "new version deployed, reload" copy; render crash → 500 page, error message shown in dev only), and a top-level [AppErrorBoundary](../../../web/src/components/common/AppErrorBoundary.tsx) outside the router with inline styles + hardcoded bilingual strings — immune to i18n/Tailwind/router failures.
- `lazyWithRetry` handles the deploy-mid-session case: a chunk 404 triggers ONE auto-reload per tab (`sessionStorage` flag, try/catch-guarded for lockdown webviews) which also picks up the waiting service worker; a second failure throws to the boundary.
## 🔌 Real error flows wired in
- [QueryState.tsx](../../../web/src/components/common/QueryState.tsx) `ErrorState` upgraded in place (contract preserved): offline detection swaps in the `errors.offline.*` copy + `WifiOff` icon, plus Retry / Report-issue action buttons. All 17 call sites now pass `onRetry={() => void q.refetch()}`.
- Expired/revoked token on session restore ([stores/auth.ts](../../../web/src/stores/auth.ts) `hydrate()` catch) now fires a Sonner toast with the shared `errors.419.*` copy and an "Open Settings" action (10 s duration — the 4 s default is too short for action toasts). Deliberately a toast, not a redirect: don't hijack whatever page the user opened. Auth gating on `/add` stays as-is.
## 🖼️ Images
- `decoding="async"` added to every `<img>` (10 sites: table thumbs, mobile cards, command palette, detail drawer, avatars, About QRs) — keeps image decode off the main thread during virtualised scrolling.
- Detail drawer header image now goes through a new `preferWebp()` ([web/src/lib/image.ts](../../../web/src/lib/image.ts)): weserv WebP transcode (~50 KB → ~20 KB) on web, **direct Steam URL on Tauri desktop** (no third-party calls from the bundled app), with an `onError` fallback to the original. Replaces the old `<picture><source>` markup, which only falls back on unsupported *type* — a weserv outage would have shown a broken image. Thumbnails intentionally stay on direct Steam capsules (~10 KB, SW-cached); `webpProxyUrl` is no longer exported.
## ⌨️ Search responsiveness
- [GamesTable.tsx](../../../web/src/components/games/GamesTable.tsx): the Fuse.js search input is wrapped in `useDeferredValue` — typing stays per-keystroke responsive while filtering ~1.2k records lags at React's low priority. No debounce timer (deferral only delays when the machine is actually busy). Same treatment + `useMemo` for the command palette's game scan.
## 🧰 Tooling & misc
- `rollup-plugin-visualizer` devDependency + `npm run analyze` (`vite build --mode analyze` → `dist/stats.html` treemap, gzip/brotli sizes).
- [index.html](../../../web/index.html): `preconnect` hints for `raw.githubusercontent.com` (shard fetches, crossorigin) and `shared.akamai.steamstatic.com` (thumbnails).
- `npm audit fix` — react-router open-redirect advisory GHSA-2j2x-hqr9-3h42 (`react-router-dom` 6.30.x patch line); `npm audit` and `pip-audit` both report 0 known vulnerabilities.
+26
View File
@@ -0,0 +1,26 @@
# v3.4.0 – 2026-06-13 (The "Legal Consent Gate" Edition)
[All versions](../../../CHANGELOG.md)
Feature release on top of v3.3.0 adding an explicit, up-front acceptance of the project's legal documents on both surfaces: a first-run consent gate in the app (web + desktop) and a real license-agreement page in the Windows installer. No backend, no cookies — acceptance is a single `localStorage` flag, versioned so it can re-prompt when the terms change, and naturally fresh in incognito/private tabs. Web app + desktop bumped `1.3.0` → `1.4.0`. Repo public-facing version `3.3.0` → `3.4.0`. Tag `v3.4.0` is GPG-signed; companion desktop tag is `desktop-v1.4.0`.
## ⚖️ First-run consent gate (web + desktop)
- New [ConsentGate.tsx](../../../web/src/components/common/ConsentGate.tsx) — a full-screen card (styled like the error pages, eager bundle, no flash) that blocks the main UI until the user ticks a checkbox and clicks **Continue**. Mounted inside `AppErrorBoundary` + `HashRouter` in [main.tsx](../../../web/src/main.tsx), wrapping `<App/>` (the `<Toaster/>` stays a sibling). A gate crash is still caught by the top-level boundary.
- **Decline path** — explicit **Decline** button: on desktop (Tauri) it quits the app via `getCurrentWindow().close()`; on web it shows a blocking "you need to accept" notice with a way back to the gate.
- **Persistence** — new [stores/consent.ts](../../../web/src/stores/consent.ts) (Zustand, same pattern as `stores/gpg.ts`): `localStorage` key `f2p:legal_consent` holding `{ version, acceptedAt }`. A `TERMS_VERSION` constant gates validity — bump it when the legal docs change materially and everyone is re-prompted. Incognito tabs get a fresh storage partition, so the gate re-shows there with zero extra code. No cookie is used anywhere (there is no server to read one).
- **Error routes pass through** — the gate lets `#/error/*` render even before consent, so a mid-session chunk-load 503, the Pages `404.html` redirect, or an `#/error/:code` deep link still reaches the user instead of being swallowed.
- **Doc links** — the gate's five binding documents (MIT License, EULA, Privacy Policy, Disclaimer, Terms of Use) open through the existing [external-open.ts](../../../web/src/lib/external-open.ts) `openExternal()` helper, so they work inside the Tauri webview (which blocks `window.open` to external HTTPS) as well as on the web.
- **Shared legal list** — the `LEGAL_DOCS` array (label / path / hint) was lifted out of [About.tsx](../../../web/src/pages/About.tsx) into a reusable [lib/legal.ts](../../../web/src/lib/legal.ts) (`LEGAL_DOCS`, `CONSENT_DOCS`, `legalDocUrl()`); About now imports it instead of holding a private copy.
- New `consent.*` i18n keys added to both [en.json](../../../web/src/i18n/locales/en.json) and [vi.json](../../../web/src/i18n/locales/vi.json). Long-form legal copy stays English (the doc labels come from `LEGAL_DOCS`); only the gate chrome is bilingual.
## 🪟 Windows installer license page
- [tauri.conf.json](../../../web/src-tauri/tauri.conf.json) now sets `bundle.licenseFile` to a new [LICENSE_AGREEMENT.rtf](../../../web/src-tauri/LICENSE_AGREEMENT.rtf). Tauri v2 surfaces this as a mandatory "I Agree" license page in **both** Windows targets built by `targets: "all"` — the NSIS `-setup.exe` (MUI license page) and the WiX `.msi` (which requires RTF). The RTF is plain ASCII with no BOM to avoid the known NSIS license-encoding bug.
- The installer gate (install-time, desktop-only) and the in-app gate (first-run, web + desktop, re-promptable) are intentionally both kept: the auto-updater replaces the binary without re-running the installer, so the in-app `TERMS_VERSION` mechanism is the only way to re-prompt updated installs.
- Desktop window-close on decline needs the `core:window:allow-close` permission, now added to [capabilities/default.json](../../../web/src-tauri/capabilities/default.json). New dependency `@tauri-apps/api` (official, lazy-imported only on the desktop decline path — no web-bundle bloat).
## 🧰 Tooling & misc
- Version bumped across the three desktop files ([web/package.json](../../../web/package.json), [tauri.conf.json](../../../web/src-tauri/tauri.conf.json), [Cargo.toml](../../../web/src-tauri/Cargo.toml)) → `1.4.0`; the stale README version badge corrected `3.2.7` → `3.4.0`.
- Pre-publish suite (`typecheck`, `knip`, `npm audit`, `vulture`, `pip-audit`) re-run clean.
+14
View File
@@ -0,0 +1,14 @@
# v3.4.1 – 2026-06-14 (The "Chart Hotfix" Edition)
[All versions](../../../CHANGELOG.md)
Patch release fixing a production regression introduced by the Vite 8 / Rolldown deploy hotfix (#95): every chart tab threw a blank **React error #130** and failed to render. Web app + desktop bumped `1.4.0` → `1.4.1`; repo public-facing version `3.4.0` → `3.4.1`.
## 🐛 Charts render again (React #130)
- [EChart.tsx](../../../web/src/components/charts/EChart.tsx) imported the chart wrapper from `echarts-for-react/lib/core` — the **CommonJS** build. Under Vite 8's Rolldown bundler the CJS default-interop wraps `module.exports = class` into a namespace object, so `<ReactEChartsCore/>` received an object instead of a component → React error #130 on **every** chart page (all [pages/charts/*](../../../web/src/pages/charts) + the [Dashboard](../../../web/src/pages/Dashboard.tsx)). Switched the import to the **ESM** build `echarts-for-react/esm/core`, which has a clean `export default`. echarts core and echarts-wordcloud were already ESM, so this single import was the only offender.
- Verified at **runtime against the production (Rolldown) build** (the step skipped in #95): bar, pie/donut, line, treemap, heatmap and wordcloud charts all render with zero console errors. `echarts`/`openpgp` remain lazy async chunks (not eager-preloaded in `index.html`).
## ⚠️ glib advisory (Linux desktop) — acknowledged, no upstream fix
- The Dependabot alert for the `glib` crate ([GHSA-wrw7-89jp-8q8g](https://github.com/advisories/GHSA-wrw7-89jp-8q8g), medium, Linux-only) cannot be resolved within Tauri 2.x: the latest `webkit2gtk` crate (2.0.2) pins `glib ^0.18`, `tao`/`wry` pin `gtk ^0.18`, and Tauri 3 is not released. Only the Linux build links glib (Windows = WebView2, macOS = Cocoa) and the app does not call the affected API, so the alert is dismissed as tolerable risk. Will revisit when the upstream stack adopts gtk-rs 0.20. See [TAURI.md](../../../web/src-tauri/TAURI.md).
+23
View File
@@ -0,0 +1,23 @@
# v3.4.2 – 2026-06-15 (The "Android Floor" Edition)
[All versions](../../../CHANGELOG.md)
Android-focused release that raises the APK's minimum OS, hides a desktop-only
affordance on phones, and documents the support policy with sourced numbers. Web
app + desktop/Android bumped `1.4.3` → `1.4.4`; repo public-facing version
`3.4.1` → `3.4.2`. Tag `v3.4.2` is GPG-signed; the Android APK ships from
`android-v1.4.4`.
## 🤖 Minimum Android raised to 11 (API 30)
- [build.gradle.kts](../../../web/src-tauri/gen/android/app/build.gradle.kts) `minSdk` `24` → `30`. Android's package installer refuses to install the APK below this (`INSTALL_FAILED_OLDER_SDK`), so the version floor doubles as the OS-level install gate — no in-app check, no bypass. Don't re-run `tauri android init` (it would reset it).
- **Why 11, not lower:** Android 7–10 are deeply end-of-life — Google ships OS security backports only for 14/15/16 as of mid-2026 — and tend to carry an outdated System WebView that breaks the modern ES2022 / React 19 output of the Vite 8 / Rolldown bundle. A `minSdk 30` floor still reaches ~87% of active Android devices (StatCounter, May 2026) while dropping only the dead tail. Android 11–13 install but no longer get Google OS patches — called out explicitly in the docs.
## 📱 "Steam Desktop" button hidden on mobile
- The `steam://` "Steam Desktop" button in [GameDetailDrawer.tsx](../../../web/src/components/games/GameDetailDrawer.tsx) can't reach a Steam client on a phone, so it's now hidden on the Android app **or** a sub-768px viewport; the "Web" button stays. Gated by a new reactive [useIsMobile.ts](../../../web/src/hooks/useIsMobile.ts) hook (`useSyncExternalStore` + `matchMedia("(max-width: 767px)")`, OR the existing `isAndroid()` from [external-open.ts](../../../web/src/lib/external-open.ts)) — re-renders on resize / rotation. No new i18n strings.
## 📚 Docs & transparency
- New [docs/android-support.md](../../../docs/android-support.md) (+ Vietnamese mirror [i18n/vi/android-support.md](../../../docs/i18n/vi/android-support.md)): minimum requirement, full rationale (security/EOL, WebView/React compatibility, edge-to-edge), tested-device matrix (emulator Android 11→16, real **vivo 1907** on Android 12), and a worldwide version-share + security-EOL table with **cited sources** ([apilevels.com](https://apilevels.com/), [StatCounter](https://gs.statcounter.com/android-version-market-share/mobile/worldwide/), [endoflife.date](https://endoflife.date/android), [Android Security Bulletins](https://source.android.com/docs/security/bulletin)). Reused as the GitHub Discussion announcement.
- Updated [TAURI.md](../../../web/src-tauri/TAURI.md), [pc_spec.md](../../../docs/pc_spec.md) (+ VN mirror) with the new Android test-device section, the [release-android.yml](../../../.github/workflows/release-android.yml) release-notes template, and the [README](../../../README.md) (version badge `3.4.1`→`3.4.2`, new Android 11+ badge + Quick-links row).
+51
View File
@@ -0,0 +1,51 @@
# v3.4.3 – 2026-09-11 (The "Own Domain" Edition)
[All versions](../../../CHANGELOG.md)
The site moved off GitHub Pages to **free-steam-games.win** on Cloudflare, and
the catalogue gained a reviewed intake path for new games plus durable manual
corrections. Web app + desktop/Android bumped `1.4.4` → `1.4.5`; repo
public-facing version `3.4.2` → `3.4.3`. Tags `v3.4.3`, `desktop-v1.4.5` and
`android-v1.4.5` are GPG-signed; both binary workflows publish **draft**
releases.
## 🌐 New home
- Served by a Cloudflare Worker with static assets; data is proxied same-origin
at `/api/data/*`, Steam art at `/img/*`. Details: [docs/DEPLOYMENT.md](../../../docs/DEPLOYMENT.md).
- Real URLs on the web (`/games/730`) instead of `/#/games/730`; old hash links
are upgraded on load. The desktop/Android shell keeps hash routing.
- Content-Security-Policy and hardening headers, with a check command for every
setting in [docs/SECURITY_SETUP.md](../../../docs/SECURITY_SETUP.md).
## 📥 New games: discovered, then reviewed
- `Discover New Games` sweeps the Steam store daily into a review queue; the
maintainer approves at `/admin` (behind Cloudflare Access). Approval queues
the game for `ingest_new.py`, and a reconcile cron confirms it landed.
- Submissions from outside now come only through the
[browser extension](https://github.com/poli0981/steam-f2p-extension); the
issue-template and Telegram-bot paths were removed.
## ✏️ Corrections that survive the pipeline
- Manual fixes (genre, notes, anti-cheat…) live in
`data/overrides/<appid>.json` and are re-applied on every write, so a refetch
or genre normalisation can no longer revert them. Edit from `/admin/edit`
(single game or bulk by genre) or `scripts/edit_game.py`.
## 📄 Data & licensing
- Dataset licensed separately under CC BY 4.0 ([LICENSE-DATA](../../../LICENSE-DATA));
code stays MIT. Terms updated, so the consent prompt appears once more.
- `description` is now a short quotation — capped at 180 characters and
attributed in the app.
- The bulk markdown tables in `games/` were removed; the two leaderboards stay.
## 🖥️ Desktop & Android
- Packaged apps now read from free-steam-games.win; the Worker sends CORS for
`/api/data/*` so they can. Builds made from `main` before this fix could not
load the catalogue — no released build was affected.
- The Tauri webview has a real CSP (`ipc:` included, so native calls keep
working). **Smoke-test the draft builds before publishing.**
+208
View File
@@ -0,0 +1,208 @@
# v4.0.0 – 2026-09-17 (The "Rewrite" Edition)
[All versions](../../../CHANGELOG.md)
The end-user web app was rewritten from React 19 to **SvelteKit 2 / Svelte 5**,
given a typeface and a palette of its own, and gained the pages it had been
missing. `/admin` was rebuilt as an app of its own, embedded in the Worker. The
data path now verifies every shard it caches, every game has a page search
engines can read, the web app is installable, and the desktop app updates
itself. Web app + desktop/Android bumped `1.4.5` → `2.0.0`; repo public-facing
version `3.4.3` → `4.0.0`.
Breaking for anyone who packaged or embedded the old build: the desktop window
is now resizable, the `tauri-plugin-http` native bridge is gone, and the
Content-Security-Policy is emitted by the app itself rather than by
`_headers`.
Deploying it needs one manual step: `npx wrangler d1 migrations apply f2p-admin
--remote` (migration `0002_admin_state.sql`). The Worker runs without it,
degraded, and `/admin/health` says so.
## 🎨 A front end that looks like something
- **Rewritten on SvelteKit 2 + Svelte 5 runes.** 30 routes, prerendered to
static HTML — every page now ships real markup to a crawler instead of an
empty shell. React, react-router, zustand, TanStack Query, cmdk and Radix
are gone; Bits UI, `@tanstack/svelte-virtual` and svelte-sonner replace
them.
- **Three self-hosted typefaces**, subsetted to Latin, Latin-Ext and
Vietnamese: Bricolage Grotesque for display, IBM Plex Sans for body and the
3,666-row table, JetBrains Mono for figures. The old build declared `Inter`
and shipped no font file at all, so it had always rendered in `system-ui`.
- **A warm amber palette**, replacing the Tailwind 3 defaults the previous
version kept "until the palette rework", plus a skip link, a
`:focus-visible` rule and a `prefers-reduced-motion` block — none of which
had ever existed.
- **A brand mark that is geometry, not a font glyph.** The old icon drew "▶"
as SVG `<text>` in `system-ui`: a different shape on every platform, and
tofu where no font supplied it.
## 📄 New pages
- `/legal/:doc` — all eight documents, rendered from the repo's markdown **at
build time**, so no markdown parser or sanitiser reaches the browser. The
welcome screen used to intercept these links and redirect to `/about`.
- `/games/:appid` — a real page per game, **prerendered for all ~3,600 games**
from build-time seeds with `VideoGame` structured data, and listed in the
sitemap. Player counts and reviews still come live from the catalogue.
- `/welcome` — a first-run introduction, shown once after the terms are
accepted: what the list is and is not, three ways in, the language, and the
documents just accepted.
- `/legal` — an index of the documents. An unknown document is a translated
404 rather than the dashboard.
- `/developers`, `/developers/:name`, `/publishers/:name` — `developer[]` and
`publisher[]` were on every record and used by nothing.
- `/stats` — the fields no chart covered: Metacritic distribution, peak-vs-now
retention, safety flags, language coverage, review-label buckets, and when
games went quiet.
- `/charts/time` gains catalogue growth (added per month, running total), and
the anti-cheat index is a searchable, sortable table.
## 🔎 Findable
- **Open Graph and Twitter cards on every page.** There were none, so a shared
link rendered as a bare grey URL everywhere. `og:image` is a real 1200×630
PNG — it used to point at an SVG, which no social platform renders.
- **Canonical URLs on every page**, not just `/games/:appid`.
- **`sitemap.xml` generated from the route table.** The old one listed four
URLs, three of them pointing at github.com, and none of the app's own routes.
- PNG icons for the PWA manifest and `apple-touch-icon`, which never accepted
SVG.
## 🛠️ `/admin` rebuilt
- **Its own app.** The two Worker-rendered pages (1,400 lines of HTML and
script inside template literals) are replaced by a Svelte 5 app in
`web/admin/`, embedded in the Worker and served only behind Cloudflare
Access, with a nonce-only script policy. None of it reaches `dist/`, the
service worker or the packaged apps, and the build fails if any does.
- **Decided rows are read-only.** Approved, committed and rejected rows, and
undecided rows for a game that is already published, have no checkbox and
are skipped by select-all. The server enforces the same rules from one shared
module, and every row a decision cannot touch comes back with a reason
instead of being dropped silently.
- **Reopen** a rejected row from its details, with the reason when it cannot be.
- Every decision is confirmed first; tabs, search, sort and page live in the
URL; keyboard shortcuts; a phone layout.
- **Corrections** are reviewed as a diff before the commit, bulk changes can set
or retire any field across pages, and a settled override file can be deleted.
- **Jobs, Audit and Health** have their own pages. Health still draws its table
when the answer is a 503, and Test write proves the write path.
- Deferring or requeueing a failed row next to an open one no longer 500s; an
approval whose commit landed but whose queue update failed says exactly that
and leaves its job marked committed.
- **Reconcile** holds a D1 lease, sweeps undecided rows whose game appeared in
`data/` by another route, and skips the dataset fetch while nothing changed.
- `audit_log` and `commit_jobs` are pruned after 180 days, as the privacy
policy now says.
- `npm run dev:admin` runs the real handlers against an in-memory database, so
the admin can be worked on without deploying it.
## 🧮 Data you can trust
- `data/index.json` carries a **SHA-256 per shard**, and `last_updated` changes
only when the data did — a pipeline run that changed nothing no longer makes
every visitor re-download ~6 MB.
- The Worker serves `?v=<sha256>` shard requests content-addressed and
immutable, and refuses (503) while GitHub's CDN still has the previous bytes.
- The app caches only a generation whose hashes verified, keeps the last good
one for offline use, and re-checks when the tab comes back. A long-lived tab
used to show a count and date days out of date.
## 📲 Installable, and updatable
- The web app registers its service worker (it never had, on the SvelteKit
build), offers installation, works offline, and asks before reloading into an
update.
- The **desktop app updates itself**: it checks a feed at
`/api/updates/desktop`, which offers only a published `desktop-v*` release,
shows the notes, and restarts into the new version. The old endpoint pointed
at the repository's "latest" release, usually a dataset release, and 404'd.
- Updating no longer wipes settings: the webview is cleared once, only when
coming from a build older than 2.0.
- `steam://` links open the Steam client from the apps.
## 🔐 Security
- **A negative `limit` disabled the SQL bound.** `Math.min(Number("-1") || 50,
200)` is `-1`, and SQLite treats a negative LIMIT as unlimited — so
`?limit=-1` dumped the entire never-pruned audit log. Clamped.
- **A token with a missing or non-numeric `exp` never expired.** `exp` is now
required and numeric.
- **The JWT is no longer accepted from a cookie on writes.** Only the
`Cf-Access-Jwt-Assertion` header, which browsers never send cross-site.
- A signing-key rotation locked out admin and ingest for up to an hour as an
opaque 404; the JWKS is refetched once on an unknown `kid`, and a fetch
failure is now a 503 rather than "not found".
- Every server crash was reported to the reviewer as "Session expired" — the
admin pages sniff Content-Type, and an unhandled throw became Cloudflare's
HTML 1101 page. There is a top-level handler now.
- A reject can no longer downgrade an approved game, which would have made it
permanently invisible to every future discovery sweep.
- `header_image` is validated as an HTTPS Steam CDN URL, not merely
length-capped.
## ✅ Tests, where there were none
`docs/ADMIN.md` claimed the override byte-parity between `scripts/edit_game.py`
and the Worker was "asserted by a parity test". No test existed anywhere in the
repo. Vitest now covers the app, the Worker (against a real SQLite database with
the real migrations) and the admin app; pytest covers the index hashing; cargo
covers the upgrade purge. The first 95 were each checked by mutation, not
merely by passing. `verify-dist.mjs` reads the built HTML in CI for the
mistakes that only exist there.
## 🖥️ Binary 2.0.0
- **The window unlocks.** It was pinned to exactly 1400×900, non-resizable and
non-maximisable, which made a responsive redesign pointless on the one
platform that could not use it. Now 1280×860, resizable, minimum 880×600.
- **`tauri-plugin-http` removed** along with its `https://github.com/*`
capability. It existed for the GitHub OAuth Device Flow, which went with
sign-in; the only remaining GitHub call is the Android release check, which
is a plain `fetch` to an endpoint that sends CORS headers.
- Real paths, no hash router. `tauri::manager::get_asset()` resolves
`/games/730` through its own fallback chain; the note claiming the webview
had no server-side fallback was out of date. Links from released 1.4.x
builds are still upgraded on load.
## 🐛 Fixed on the live site
- Raw placeholders on screen: `Languages ({{count}})`, `(PEAK {{PEAK}})` as a
field label, `(peak {{peak}})` on a chart axis, and one in a prerendered meta
description. A test now reads every call site.
- Hovering a chart tile, bar or slice blanked it (the colour format zrender
cannot parse), the genre treemap tooltip printed `({d}%)`, and axis names
were clipped on `/stats`.
- The command palette crashed on open (a duplicate route), the consent overlay
covered the documents it asked people to read, unknown URLs rendered the
dashboard, and old `/#/` links changed the address bar without the page.
- Vietnamese readers saw English for the legal document names, the table's
data-issue hints and the About page's stack. 137 locale keys nothing used any
more are gone, and a test fails on the next one.
- The report-only CSP messages in the console come from Cloudflare's
Continuous script monitoring, not the site; `docs/SECURITY_SETUP.md` says how
to turn it off.
## 🐛 Console
Every reported error is fixed, and each was measured rather than assumed:
- GitHub avatars were blocked by CSP on `/activity`. They are proxied through
the Worker at `/img/gh/*`, so `img-src` stays `'self'`.
- The Cloudflare Access re-auth fetch was blocked. It uses a full-page
redirect now.
- `[Violation] 'setTimeout' handler took 122ms` — zero long tasks while four
charts initialise, because each waits for an IntersectionObserver instead of
all of them racing in one frame.
- `[Violation] non-passive 'mousewheel' listener` — zrender binds both `wheel`
and `mousewheel` with no options object, unconditionally. Four blocking
listeners for two charts, measured; now zero.
## 📇 Contact
The maintainer address is **contact@poli0981.dev**; every other channel is
`https://poli0981.dev/links/`. `CODE_OF_CONDUCT.md` had no reporting address at
all. `/.well-known/security.txt` exists and is served as `text/plain` — it used
to return the app shell with HTTP 200.
+133
View File
@@ -0,0 +1,133 @@
# v4.0.1 – 2026-09-23 (The "Human Check" Edition)
[All versions](../../../CHANGELOG.md)
The web app now asks each browser to pass a Cloudflare Turnstile check once a
day after the terms are accepted, shows a changed legal document as a diff
instead of asking for a full re-read, and counts page views with Cloudflare
Web Analytics. The desktop app's game artwork - blank because its webview
sends a Referer the zone's Hotlink Protection refuses - is back, and nothing in
the app loads data before the reader is past the consent step and the check. Web app + desktop/Android
bumped `2.0.0` → `2.0.1`; repo public-facing version `4.0.0` → `4.0.1`.
The web changes are already live - pushing `main` deploys. The desktop app
offers 2.0.1 through its updater once the release is published; on Android,
install the new APK over the old one. Returning visitors see the consent gate
once, listing only the Privacy Policy and Terms of Use changes.
## ✨ Added
- **A legal document that changes now shows you the change, not the whole
document again.** Each binding document is hashed at build time
(`virtual:legal-versions`); when one differs from the version you accepted,
the consent gate reopens on its own and lists only that document, with a
`+`/`-` diff against the copy kept in your browser. `TERMS_VERSION` is no
longer the only signal — it stays as the lever that forces a full re-read.
Clearing site data removes the stored copy, and the gate then links to the
full text instead.
- **Cloudflare Web Analytics**, cookieless, loaded only after you accept the
terms and never in the desktop or Android apps. It replaces an "automatic"
edge injection that had been enabled for months and could never have worked:
it inserts an inline script, and a hash-based CSP ignores `'unsafe-inline'`
by specification, so it only ever produced two console errors per page load.
Measured on the live site: the beacon returns 200 and its reports 204, with
nothing loaded at all before consent.
- **A human-verification step for suspicious page loads, and a country block**
(mainland China, Russia, Argentina). Both are WAF custom rules, live since
2026-09-20 and documented with their expressions and every exclusion in
`docs/SECURITY_SETUP.md`. Verified after they went live: a plain `curl` with
no browser User-Agent is still served every public path, and the challenge
rate has stayed at 0%. `BLOCKED_COUNTRIES` in `wrangler.jsonc` makes the
Worker refuse the same countries as defence in depth; the rule is the
boundary, because prerendered pages never reach the Worker at all.
- **A Cloudflare Turnstile check on the website**, separate from the WAF
challenge above: after accepting the terms, each browser passes a Turnstile
widget at most once every 24 hours before the app loads its data. The Worker
verifies the token at `POST /api/human-check` with the `TURNSTILE_SECRET`
secret, checking the action and the hostname; nothing is stored server-side.
It is an overlay like the consent gate, so prerendered pages and crawlers are
unaffected, and it is soft on purpose: `/api/data/*`, `/img/*` and the
desktop and Android apps never require it (the Terms of Use promise as much).
It refuses only when Cloudflare says no; a missing secret, a siteverify
outage, a widget misconfiguration or being offline let the reader through for
that page load. The web CSP gains `challenges.cloudflare.com` in `script-src`
and a new `frame-src`; `verify-dist.mjs` fails the Tauri build if either
appears there. The privacy policy and the terms describe it, so returning
visitors see those two documents' changes at the consent gate once.
## 🐛 Fixed
- **Game artwork was blank in the desktop app** (and would be on Android): the
WebView2 webview sends `Referer: http://tauri.localhost/`, and the zone's
Hotlink Protection refused every `/img/*` request carrying it — before the
Worker ran, so nothing in the app's logs showed it. Every `<img>` now sets
`referrerpolicy="no-referrer"`, which the protection allows, and
`src/lib/images.test.ts` fails on one that does not. That also fixes the
thumbnails `npm run dev` could never show. Installed 2.0.0 apps are covered
by a Configuration Rule on the zone until they update; Hotlink Protection
itself stays on for other sites.
- **`/activity` and `/charts/delisted` fetched their data before consent.** The
root layout held the catalogue back, but those two pages called `load()`
from effects of their own, and the activity feed also refetched on window
focus. The gate now lives in `Resource` itself: an `enabled` option read
inside every `load()`, which every resource sets to `appReady()` - consent
accepted and the human check cleared - so a held-back load starts by itself
once both are passed. `src/lib/resource.test.ts` fails on a `new Resource`
without it.
- **The service worker threw `non-precached-url: /200.html` on every page
load.** `navigateFallback` named the adapter-static fallback, which is
written into `dist/` after workbox has already globbed the build output — so
it was never in the precache, and the throw abandoned the rest of the
worker's setup. It is now `/`, which is both precached and what Cloudflare
and Tauri already serve for an unmatched path. `verify-dist.mjs` fails the
build if the two ever disagree again.
- **`/admin` no longer writes the maintainer's email address into public Git.**
Commit bodies and `data/overrides/*.json` say `admin`; the four override
files that already carried it were rewritten. The acting identity is still
recorded in D1, where `/admin/audit` reads it.
- **`/admin` said "Your Cloudflare Access session has expired" straight after
signing in, in a private window too.** Its API was at `/api/admin/*`, behind
a second Cloudflare Access application. Access issues its session cookie per
application and `fetch()` cannot follow the sign-in redirect, so the session
for `/admin` never reached the API and every call bounced to the login page.
The API now lives at `/admin/api/*`, under the page's own application, and
`worker/index.test.ts` drives it through the real router and token check.
The `/api/admin` Access application is no longer used and can be deleted.
- `scripts/discover_new.py` took any host ending in `cloudflareaccess.com` for
an Access login page, lookalikes included; the suffix check now needs the dot.
- The i18n, SEO and chart tests share one comment stripper instead of three
regexes, one of which removed text that was never inside a comment.
## 📚 Docs
- `docs/ACKNOWLEDGEMENTs.md` listed the dependencies of the **React** app —
React 18, react-router, i18next, Zustand, TanStack Query, Radix, shadcn/ui,
OpenPGP.js, Tailwind 3, TypeScript 5, PostCSS. None of that has shipped since
the v4 rewrite. Replaced with the real list, licences checked against
`node_modules` rather than remembered (`echarts-wordcloud` is ISC, not
BSD-3-Clause), and the claim that `/about` carries a "full SPDX list" dropped
— it is a curated subset.
- `docs/DEPLOYMENT.md` records that a zero-duration "Workers Builds" failure on
a PR branch is a preview-build artefact, not a broken commit, so the next
person does not go looking for a bug that is not there.
- `docs/SECURITY_SETUP.md` section 10 claimed the packaged apps survived Hotlink
Protection because their webview sent no Referer, recommended switching the
protection off, and said no allowlist could express the apps' origin. The
first was no longer true and the last never was; it now documents the
per-image fix and the Configuration Rule, with the measured check. A new
section 12 covers the Turnstile widget settings, the secret and local testing
with Cloudflare's test keys (`web/.dev.vars.example`).
- Stale `public/_headers` paths (the file has been `static/_headers` since the
SvelteKit move) and a `SITE_ORIGIN` that is really `API_ORIGIN` in
`src/lib/site.ts` are corrected in `worker/lib/http.ts`, `svelte.config.js`
and the security doc; `_headers` itself gains comments on why images opt out
of its Referrer-Policy.
## 🛠 CI
- The Android release builds the tag it releases (a manual run used to build
`main`), installs `platform-tools` only (the SDK no longer carries `tools`,
which stopped `android-v2.0.0`), and names the commit it built.
- CodeQL also runs when only `.mjs`/`.cjs` files change, and
`verify-dist.mjs` finds `<script>`/`<style>` by scanning.
+56
View File
@@ -0,0 +1,56 @@
# v4.0.2 – 2026-09-29 (The "Right Address" Edition)
[All versions](../../../CHANGELOG.md)
A game's tags, languages and store details are now re-read on a rotation
instead of being fetched once and never again, a long data job no longer loses
its work when something else lands on `main`, and each kind of message now has
an address of its own. Web app + desktop/Android bumped `2.0.1` → `2.0.2`; repo
public-facing version `4.0.1` → `4.0.2`.
The web changes are live as soon as this merges. The desktop app offers 2.0.2
through its updater once the release is published; on Android, install the new
APK over the old one. Returning visitors see the consent gate once, listing
the Privacy Policy, the Terms of Use and the Data Licence — each changed only
by a contact address, and the gate shows exactly that line.
## ✨ Added
- **Tags, languages and the rest of a game's store data now stay current.**
`update_data.py` only fills in incomplete records, and only empty fields, so
once a game had its tags, languages, platforms or header image nothing looked
at them again short of a manual full re-fetch. `Refresh Store Data` (daily,
16:00 UTC) re-reads them on a rotation: the store page - tags, languages and
their details, the paid-DLC flag - for every game once a week, and
appdetails - name, header image, description, developer and publisher,
release date, platforms, Metacritic, DRM notes - once a month. About 630
store pages and 150 appdetails calls a day instead of 8,800 requests in one
sitting. It never blanks a value on a failed or age-gated page, never
touches the hand-set fields (genre, type, anti-cheat, safety, notes), and
marks a game updated only when something changed. A dry run on three games
found all three with tags that had drifted since they were first fetched.
## 🐛 Fixed
- **A long data job lost its work if anything landed on `main` meanwhile.**
`purge-unhealthy` ran for four hours on 2026-09-21 and then failed on
`push rejected (fetch first)`: the data-write group serialises workflows,
but a merged pull request or an `/admin` commit still moves `main`. Every
data job now commits through `bash/commit_push.sh`, which rebases onto
`origin/main` and retries the push.
## 📇 Contact
`contact@poli0981.dev` stays the default. Three role addresses join it, each
published where a reader of that document would look:
| Address | For | Where |
|---|---|---|
| `security@poli0981.dev` | vulnerabilities, after GitHub's private reporting | `SECURITY.md`, `/.well-known/security.txt` |
| `privacy@poli0981.dev` | privacy questions | Privacy Policy |
| `copyright@poli0981.dev` | copyright, DMCA and takedown notices | Data Licence, Terms of Use §6 |
The maintainer's website, <https://poli0981.dev/>, is on the About page next
to the email and the links page. `security.txt` now lists GitHub's private
vulnerability reporting first and `security@` second, in RFC 9116 preference
order. The full map is in `AUTHORS.md` and `docs/Contact.md`.
+67
View File
@@ -0,0 +1,67 @@
# v4.1.0 – 2026-10-02 (The "Featherweight" Edition)
[All versions](../../../CHANGELOG.md)
Game art and the catalogue both got much lighter, the deploy log lost its
noise, and scrollbars finally look like the rest of the site. Web app +
desktop/Android bumped `2.0.2` → `2.1.0`; repo public-facing version `4.0.2` →
`4.1.0`.
The web changes are already live. The desktop app offers 2.1.0 through its
updater once the release is published, and brings the packed catalogue with
it; on Android, install the new APK over the old one. Returning visitors see
the consent gate once, showing one new line in the Privacy Policy: the storage
key of the new scrollbar setting.
## ✨ Added
- **Game art is AVIF now - heroes about 58% smaller, thumbnails about 92%.**
The Worker's 15-minute cron encodes each game's Steam header once with
Cloudflare Images - a 230 px thumbnail and a 460 px hero - and stores it in
R2; every request after that is served from the stored copy, never encoded
on the fly. The ten most-played heroes went from 40 KB to 16.8 KB (SSIM
0.979 against Steam's JPEG); thumbnails are ~3.4 KB. Most-played games go
first, the whole catalogue takes about a day and a half, and a hard monthly
cap keeps the Images bill bounded. Browsers that do not take AVIF keep
getting Steam's JPEG, and social cards always do.
- **The catalogue downloads in about a seventh of the bytes.** The app now
reads each shard as a packed file (`/api/data/p1/*.bin`, 224 KB instead of
1.5 MB): compressed, and wrapped so the site's API is no longer a
ready-made JSON feed. It is obfuscation, not secrecy - the readable dataset
is the repository, as it always was. The app checks what it unpacks against
`index.json` exactly as before, and the released apps keep reading the
plain files.
- **Scrollbars match the site, and can be hidden.** A warm thumb that turns
amber under the pointer, in both themes. Settings → Scrollbars: Visible,
Hidden in tables and panels, or Hidden everywhere; hidden bars still scroll
with the wheel, trackpad, touch or keyboard.
## 🐛 Fixed
- **Every deploy log was 91% noise.** The build printed one
`[404] GET /img/…` per prerendered game - 5,566 lines - and rendered an
error page for each. They were harmless (a Worker route the build cannot
see), but they buried anything worth reading. Now there are none.
- **The plain catalogue went out uncompressed.** Cloudflare does not compress
`application/x-ndjson` by default, so every full load moved ~9 MiB. A
Compression Rule now brotli-compresses those files for every client,
released apps included (1.5 MB → 226 KB per shard).
- **Tables showed the operating system's grey scrollbar.** Tailwind 4.3's own
`scrollbar-thin` merged with ours and, in Chromium, switched the themed bar
off. Ours is now `scrollbar-slim`, with a test that keeps it that way.
- **Thumbnails cost two guaranteed 404s on half the catalogue**, probing for a
Steam capsule that hashed paths never have, and stray query strings forked
the image edge cache.
- **A data-only commit redeployed the whole site** (5,681 files), against
what `docs/DEPLOYMENT.md` intends. The fix is the Workers Builds watch
paths, a dashboard setting.
## 🔐 Security
- **`/img/*` can no longer be used to run up the image bill.** With
Cloudflare's URL transformations enabled, `/cdn-cgi/image/<options>/img/…`
let anyone bill a new transformation per option set, through a proxy that
serves any Steam game's art - a scanner found such a URL within minutes. The
Worker now refuses the transformation service as a client, and URL
transformations are switched off for the zone; the cron's encoding does not
need them.
+75
View File
@@ -0,0 +1,75 @@
# v4.1.1 – 2026-10-03 (The "Pocket-Sized" Edition)
[All versions](../../../CHANGELOG.md)
The site and the apps fit a phone: nothing runs off the right edge, game
names are back in the leaderboards, and the Android app no longer puts its
top bar under the clock. Web app + desktop/Android bumped `2.1.0` →
`2.1.1`; repo public-facing version `4.1.0` → `4.1.1`.
On the website the phone fixes go live with this release; the caching
changes below already were. The desktop app offers 2.1.1 through its updater
once the release is published; on Android, install the new APK over the old
one. The apps also pick up the Privacy Policy line about the image host
below, so they show the consent gate once, with that paragraph; the website
already did.
## 📱 Fits a phone
- **Nothing runs off the right edge any more.** On a phone, the Dashboard's
"Top genres", "Playing right now" and chart cards, and every card on
Developers and Publishers, were wider than the screen: the counts and the
"View all" links were cut off and the page slid sideways. One long name was
enough, because a grid with no column count for small screens grows to fit
its longest line. Every grid now starts at one column that fits the screen,
and a test fails on any grid that does not.
- **Game names are back in the leaderboards.** Top Online, Top Offline and the
developer and publisher pages squeezed the name to nothing to make room for
the genre badge and the review score. On a phone those two now give way to
the name.
- **The Android app keeps out from under the status bar.** Since 2.0.0 the top
bar sat under the clock and the battery icon: the safe-area padding the 1.x
app had was lost in the rewrite. The page, the menu, the dialogs, the
back-to-top button and the notifications clear the status and navigation
bars again, and a strip behind the status bar keeps the clock readable
whichever theme the app and the phone are in. This needs Android System
WebView 136 or newer, which any phone that updates it from the Play Store
has.
- **Charts that fit.** On a phone the Anti-Cheat, Delisted and Catalogue
growth legends no longer cover the chart, axis numbers no longer print on
top of each other, and the tag cloud shows the most common tags instead of
dropping exactly those.
- **Smaller fixes.** The header search shows its hint instead of "Search by
na"; on /games a game with a long anti-cheat name no longer paints over the
next card; the consent gate scrolls to its top on a short screen; long
names and links in titles and game descriptions wrap instead of widening
the page.
## ⚡ Faster repeat visits
- **Static files are cached by what they are.** Only the hashed scripts,
styles and fonts had a lifetime; the icons, the favicon, the social card,
the manifest and Workbox's runtime were asked for again on every page load.
Workbox's hashed runtime is now cached for a year like the rest of the
build, and the art and manifest are fresh for a day and then refreshed in
the background. Pages, the service worker and the version signal still
revalidate every time, so a deploy - or a changed legal document - shows
on the next load.
- **Game art comes straight out of Cloudflare's cache.** Every thumbnail and
hero ran the site's Worker on every view, however often it had been seen -
a Worker always runs before the cache. The website now loads the AVIF
copies from the site's own image host, `media.free-steam-games.win`, which
Cloudflare caches like any static file, and falls back to the old address
by itself for art the cron has not converted yet or a browser without AVIF.
The desktop and Android apps are unchanged. The Privacy Policy now names the
image host, so returning visitors see the consent gate once, showing that
paragraph.
## 📚 Docs
- `docs/DEPLOYMENT.md` explains which commits deploy: documentation commits
stopped deploying, data commits still did, and it gives a configuration that
stops both - with the one trap: the legal documents are read by the build,
so a commit that changes only them must still trigger one.
- `docs/android-support.md` (and its Vietnamese mirror) says which Android
System WebView the safe areas need, and what to do on an older one.
+67
View File
@@ -0,0 +1,67 @@
# v4.2.0 – 2026-10-03 (The "All-Time High" Edition)
[All versions](../../../CHANGELOG.md)
Every game now shows the most players it has ever had at once, the catalogue
the site and the apps keep for offline use is a fraction of its old size and
no longer readable as text, and every open dependency alert is closed. Web
app + desktop/Android bumped `2.1.1` → `2.2.0`; repo public-facing version
`4.1.1` → `4.2.0`.
On the website all of this is already live. The desktop app offers 2.2.0
through its updater once the release is published; on Android, install the
new APK over the old one. The apps also pick up the Disclaimer's new
paragraph on where player numbers come from, so they show the consent gate
once, with that paragraph; the website already did.
## ✨ Added
- **All-time peak players.** Every game shows the most players it has ever had
at once: "All-time peak" on its page, and a sortable column in the games
table and the CSV export. The number is the peak Steam Charts has recorded,
which for a game it tracks goes back to the launch, read about once a month
per game; for the many small games Steam Charts does not track, it is the
most this project's own samples have seen. It only ever goes up. The
"(peak N)" beside the player count is gone: it was the highest of our own
occasional samples since the last full re-fetch, not a daily or all-time
peak, and it read like one. The Disclaimer names the new source, so
returning visitors see the consent gate once, showing that paragraph.
## 🗜️ A smaller, opaque offline cache
- **The catalogue your browser or app keeps for offline use is now stored as
the packed shards it downloads**, not as thousands of readable records:
about 1.4 MB instead of roughly 9.5 MB, and opaque bytes in DevTools.
Like the packed downloads, this is compression and obfuscation, not
protection: the key is public, and the dataset stays readable in Git. The
copy an earlier version saved keeps working until the data next changes,
then it is replaced and deleted. Same storage keys, so the Privacy Policy
and the consent gate are unchanged.
- Opening the cached catalogue happens off the main thread now: on a
desktop the longest freeze while loading it fell from about 20 ms to 6 ms,
for about 45 ms more until the data is ready. The two cache keys are now
written in one transaction, so a failed write can no longer leave a new
index next to old data, and a cache that will not open is simply
downloaded again.
## 🧰 Pipeline
- `scripts/refresh_peaks.py` and the daily "Refresh All-Time Peaks" workflow
(19:30 UTC) ask Steam Charts about a thirtieth of the catalogue a day, a
page every two to three seconds, and stop for the day if it ever refuses;
every run also raises the field from the pipeline's own player counts. A
manual run with `backfill` ticked asks about every game at once, in about
four hours.
## 🔐 Security
- **Every open dependency alert is closed** (19 from Dependabot, plus the few
`npm audit` adds); `npm audit` reports none. Only two of the packages run in
production: `devalue`, whose parser is in the page and the apps (5.9.2 →
5.9.4), and `urllib3` in the data pipeline (2.7.0 → 2.8.0). The rest are
build and development tools: `undici` comes up to 7.29.1 with wrangler
4.147.0, and `brace-expansion`, `fast-uri` and `serialize-javascript` are
lockfile-only bumps. SvelteKit 2 still asks for `cookie` 0.6, whose fix is
only in SvelteKit 3, so an npm override gives it 0.7.2 (same API; with the
static adapter that code only runs while the site is built). The `sharp`
override is gone: wrangler's own pin now holds the patched version.
+47
View File
@@ -0,0 +1,47 @@
# v4.2.1 – 2026-10-10 (The "Age Gate" Edition)
[All versions](../../../CHANGELOG.md)
Adult Only games now have their tags, languages and paid-DLC flag. Every
release date reads the same way, and the catalogue's text no longer carries
HTML escapes, invisible characters or Vietnamese notes. Only the data
pipeline changed: the web app and the desktop/Android apps stay at `2.2.0`,
with no new build. Repo public-facing version `4.2.0` → `4.2.1`.
The fixes reach the catalogue through the pipeline itself. The next data job
rewrites the dates, notes and text once. The next `Refresh Store Data` run
fills the games that were empty. Every app, old or new, picks the changes up
with its next catalogue download.
## 🐛 Fixed
- **Adult Only games had no tags, no languages and the wrong paid-DLC flag.**
Steam answers an anonymous visit to such a game's store page with its age
check, a Sign In page no cookie gets past, and the pipeline read that page
as the game's own: no language table, no tags, no DLC section. 25 games
were stuck that way: about 16 adult games, plus Warframe, PUBG, Rainbow Six
Siege and other age-rated games that were gated on the US servers the
pipeline runs on. Every one of them was marked "no paid DLC". A gated page
is now recognised and never read. Those games come from Steam's own store
data instead: tags, languages with their interface/audio/subtitle columns,
and the paid-DLC flag from the prices of their DLC. A game with empty tags
or languages is retried every day until they fill.
- **"Point &amp; Click".** 458 games had the tag written out with its HTML
escape, next to 10 with "Point & Click", so the tag filter listed both
(also "Design &amp; Illustration" and "Animation &amp; Modeling"). About 320
descriptions showed `&quot;` instead of quotation marks.
- TrackMania Nations Forever listed a language called "#lang_slovakian"; it
is Slovak.
## 🧹 Changed
- **One release-date format.** Every release date reads like "Aug 21, 2012".
The catalogue held three shapes: about 1,360 games in "21 Aug, 2012" and
one in Russian. Dates sent in another order or another store language are
converted when they are saved. Placeholders such as "Coming soon" are left
as they are.
- The note "Có DLC trả phí", which the browser extension wrote on 482 games,
now reads "Has paid DLC".
- Invisible characters (zero-width spaces, stray direction marks) and stray
spaces or tabs are removed from 56 games' names, developers, publishers and
descriptions. Two games listed a publisher that was only a space.
+87
View File
@@ -0,0 +1,87 @@
# v4.3.0 – 2026-10-13 (The "Autopilot" Edition)
[All versions](../../../CHANGELOG.md)
The admin can now approve the review queue on its own, a batch at a time and
within a daily limit, and it can take games out of the catalogue and put them
back. Four new admin pages show what is going on. Only the admin, its Worker
routes and the data pipeline changed: the desktop and Android apps stay at
`2.2.0` with no new build, there is no D1 migration, and the GitHub App keeps
the same permissions. Repo public-facing version `4.2.1` → `4.3.0`.
Auto-approve is **off** until it is turned on at `/admin/automation`.
## ✨ Added
- **Auto-approve.** Every 15 minutes the Worker's cron can approve one batch
of pending games, exactly as a reviewer's Approve does: a request in
`scripts/temp_info.jsonl` that the ingest still checks game by game (free,
reachable, a game, not already listed). The page sets the limits: games per
batch (up to 100), games per day (up to 500, a ceiling written in code), a
minimum wait before a game can be taken, the order, and which discovery
sources. A batch is committed only when the previous one has been ingested
and no data job is running or waiting its turn, since pushing then would
cancel that job. Anything it cannot check counts as "not now". **Run one
batch now** does one on demand, within the same limits.
- **Removing games.** `/admin/remove` takes up to 100 games out of the
catalogue at once, with a reason from a fixed list and an optional note.
Both are public. A removal is a line in the new `data/blocklist.jsonl`, and
every pipeline write leaves those games out. No scrape, re-fetch or
browser-extension push can bring one back, and discovery never proposes it
again. Each removal is logged once in `scripts/removed_games.jsonl`, so the
game's page says it was removed and why. **Restore** puts a game back in one
commit, and the game is fetched fresh from Steam. `scripts/delete_game.py`
does the same from the command line. It used to be an interactive prompt
that kept no record and did not stop the game from coming back.
- **Overview** at `/admin`, with one card each for the queue, auto-approve's
day, removals waiting for the pipeline, data jobs running now, data-quality
totals, and commit jobs that failed or are stuck. The queue moved to `/admin/queue`, and old
links are forwarded there.
- **Pipeline** (`/admin/pipeline`): the latest runs of every data workflow, and
what is running or waiting.
- **Data quality** (`/admin/quality`): published games with something missing
or unreviewed, such as safety never set or never reviewed, no genre, no tags
or no publisher. Each game links to its Edit page.
## 🐛 Fixed
- **A free DLC, demo or tool could be added as a game.** The ingest now
refuses anything Steam does not call a game, and logs it as `not_a_game`.
This applies to the browser extension too.
- `ingest_new.py` crashed on an entry whose link was a number, and would have
crashed again on every three-hourly run until the file was cleaned by hand.
A number is now read as an appid, and anything else unusable is counted as
a bad entry.
- An ingest run that waited behind a long data job worked on the data as it
was when the run was queued. It now starts from the tip of `main`.
- `Mark Dead Games` pushed with a bare `git push`, so a commit landing during
its run threw the run away. It now commits through the same
rebase-and-retry helper as every other data job.
## 🧰 Pipeline
- `scripts/remove_games.py` applies the blocklist. `Ingest New Game Links`
runs it before every ingest, and a push to `data/blocklist.jsonl` starts that
workflow. A save that would remove more than 500 games stops before writing
anything, so a damaged file fails loudly instead of emptying the catalogue.
`Check Overrides` validates the blocklist on every push that touches it.
- Discovery counts removed games as already known.
## 🔐 Security
- The app shell's lockfile takes `rustls` 0.23.45 (and `rustls-webpki`
0.103.15), closing GHSA-2mjx-qc3c-rqvc: TLS 1.3 handshake messages were
accepted across encryption-level boundaries. Only the desktop updater's
HTTPS client uses it; the Android app does not include it. The desktop app
picks it up in its next build, and 2.2.0 is unchanged.
## 🧹 Housekeeping
- 25 merged branches on GitHub, their local copies and 7 stale worktrees are
gone. GitHub now deletes a pull request's branch when it is merged.
- Dependencies: Tauri 2.12.2 and its plugins (#181), and eleven npm
minor/patch updates including Svelte 5.57.2, Vite 8.3.4 and wrangler
4.149.0 (#182). The website already runs them; the apps pick them up in
their next build. Dependabot no longer proposes SvelteKit 3,
adapter-static 4, a new Svelte, Tailwind or TypeScript major, or a
`@types/node` ahead of the Node 24 the project runs on.
+78
View File
@@ -0,0 +1,78 @@
# v4.3.1 – 2026-10-16 (The "Fair Play" Edition)
[All versions](../../../CHANGELOG.md)
Anti-cheat information comes from Steam again, for every game, and the
retired browser extension leaves the repository. Only the data pipeline, the
admin, the docs and two legal documents changed: the desktop and Android apps
stay at `2.2.0`, with no new build. Repo public-facing version `4.3.0` →
`4.3.1`.
The data catches up through the pipeline itself. The first data job after
this release cleans the notes once (about 520 games). The first anti-cheat
sweep fills and corrects every game Steam has a declaration for, and every
daily sweep after it keeps them in step.
## 🐛 Fixed
- **No game added since September had an anti-cheat.** The browser extension
was the only part of the project that read the anti-cheat a developer
declares on Steam, and it stopped in June; the pipeline itself only looked
for VAC. None of the 4,700 games added since then had one, Delta Force's
kernel-level ACE included. The pipeline now reads Steam's own declaration:
the product, whether it runs in the kernel, and whether it needs Secure
Boot. It does so when a game is added, and for the whole catalogue every
day. More than 80 games that declare an anti-cheat on Steam had none here,
among them Brawlhalla, Destiny 2, THE FINALS, Delta Force, Albion Online,
SMITE 2, Throne and Liberty and Dark and Darker; about 20 more get the
kernel flag or note they were missing. A developer who types a paragraph
where the product name goes gets a label cut to 40 characters, with the
whole text kept in the note.
- **Where the list and Steam disagree, Steam's declaration wins.** Wuthering
Waves uses ACE, not EAC; Jujutsu Kaisen Phantom Parade's anti-cheat does not
run in the kernel; Marvel Rivals' kernel flag is now known. A correction
made in the admin still beats Steam. A game that declares nothing on Steam
keeps what it has, because no declaration is not proof that a game has no
anti-cheat (Warframe, Overwatch 2 and NARAKA declare none).
- A game whose anti-cheat had been reset to an empty value had only its first
Steam category checked for VAC, and a full re-fetch reset `-` to an empty
value.
## ✨ Added
- **The anti-cheat sweep** (`scripts/refresh_anticheat.py`), at the end of the
daily Refresh Store Data run, with a commit of its own. About 160 requests
to Steam's store API cover every game; a store page is read only for a
declaration whose name the API leaves out. A manual Refresh Store Data run
with `only: anticheat` runs just the sweep.
## 🧹 Changed
- **The browser extension is archived**
([steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension);
v2.8.0 was its last release). The ingest queue (`scripts/temp_info.jsonl`)
now takes store links only: any other key on a line is ignored, and the game
is fetched from Steam. The code that merged the extension's fields is gone,
along with the field lists that existed only for it.
- The notes the extension left behind are removed: "Has paid DLC" at the
start of 491 notes (the paid-DLC flag already says it, and 10 of those notes
contradicted the flag) and "[hover-add]" on 26. A note left with nothing
else reads "Not reviewed yet".
- DISCLAIMER section 5 and Terms of Use item 5 now say where anti-cheat comes
from: the developer's declaration on Steam. On the website the consent
screen shows those two changes once.
- "Denuvo", Steam's name for Denuvo Anti-Cheat, is grouped with it in the
charts and filters.
## 🧰 Pipeline
- Refresh Store Data checks out the tip of `main` when it starts, as the
ingest does, so a run that waited its turn works on current data.
- A retired override whose old value equals its new one no longer counts as a
change on every save.
## 📚 Docs
- README, CONTRIBUTING and the contact page no longer send anyone to the
extension. A missing game or a correction goes in Discussions › Ideas, and
the manual fork path queues links only.
+24
View File
@@ -0,0 +1,24 @@
# v4.3.2 – 2026-10-16 (The "Pigeonhole" Edition)
[All versions](../../../CHANGELOG.md)
The anti-cheat charts and filters know the products Steam's declarations
brought in. Only the website's anti-cheat grouping and the pipeline's labels
changed: the desktop and Android apps stay at `2.2.0`, with no new build, and
group these products from their next release. Repo public-facing version
`4.3.1` → `4.3.2`.
## ✨ Added
- **Seven more anti-cheat families**: ACE (Anti-Cheat Expert), Anti-Cheat
Toolkit, CrackProof, HoYoKProtect, NGS (Nexon Game Security), EA Javelin and
SARD. After v4.3.1, 68 of the 159 games with a named anti-cheat sat in the
charts' "Other" slice; now 35 do, and those are one-off names a developer
typed. New games get the short name as their label; a label already stored
stays as it was written, so nothing in the catalogue is rewritten.
## 🐛 Fixed
- A product name now has to appear as a whole word to count. Matching inside
words would have filed "Space Guard", "Interface Shield" or "Peacekeeper"
under ACE, and "Vacuum Protect" under VAC.
+64
View File
@@ -0,0 +1,64 @@
# v4.3.3 – 2026-10-19 (The "Locksmith" Edition)
[All versions](../../../CHANGELOG.md)
The one open code-scanning alert is fixed, and what SonarCloud found on
`main` is fixed or accounted for: CI installs only what it has pinned and runs
no dependency's install code, the Android app stops copying its data into
Google's backup, and the parsers lose the regexes that could backtrack.
Desktop and Android bumped `2.2.0` → `2.2.1`; repo public-facing version
`4.3.2` → `4.3.3`.
The apps also catch up with the website: the new Contact page, the reworded
anti-cheat paragraphs of the Disclaimer and the Terms (so they show the
consent gate once, with those paragraphs), and v4.3.2's anti-cheat grouping.
The desktop app offers 2.2.1 through its updater once the release is
published; on Android, install the new APK over the old one.
## 🔐 Security
- **Code scanning is clean again.** The worker that decodes the catalogue now
refuses a message from any origin but its own (CodeQL
`js/missing-origin-check`). Only the page that started it can reach it, so
nothing changes for anyone; the alert had been dismissed once and came back
as soon as the code around it moved.
- **CI installs only what it has pinned.** The release workflows, which hold
the signing keys, pin every third-party action to a commit. Every `npm ci`
runs with `--ignore-scripts`, and no workflow uses `npx`. The Python
pipeline pins every package it installs, the dependencies' dependencies
included, with the hash of each file, and installs wheels only
(`--require-hashes --only-binary :all:`), so no package's setup script runs
and nothing unlisted is installed.
- **The Android app no longer takes part in Android's Auto Backup.** Left
unset, Android copied the app's storage (your consent, your settings and
the cached catalogue) into your Google account's backup, while the Privacy
Policy says none of it leaves your device. From 2.2.1 it stays there; on a
new phone you accept the terms again.
- The source no longer contains raw invisible or right-to-left control
characters: the pipeline's lists of characters to strip spell them as
escapes.
## 🧹 Changed
- Regexes that could backtrack quadratically on long input are linear now:
the store page's tags and "unsupported" language rows, the discovery
sweep's search rows, the review percentage and label, the chart colour
tokens, the legal pages' titles, the image route's capsule path and a few
more. Each new form was checked against the old one, on the dataset and on
random input.
- Lists sorted for a build hash, the sitemap or a test R2 listing state the
code-unit order they always had; the admin stylesheet puts its `@import`s
first, as CSS requires (the built stylesheet is byte-for-byte the same);
`Number.parseInt` over the global, `[[ ]]` in the bash wrappers; the unused
`normalizeLink` is gone; the Steam client mounts its retrying adapter for
https only.
- New tests pin the store page's tag and language parsing, the discovery
sweep's rows, the review summary parsing and the worker's origin check.
## 📚 Docs
- `CLAUDE.md`: the worker's origin check, the CI pinning rules (and how to add
a Python dependency), the Android backup decision. `docs/dev_env.md` and its
Vietnamese copy: run the pipeline from the repo root, with the hashed
installs; they said `cd scripts`, from where `data/` cannot be found.
`docs/DEPLOYMENT.md`: what CI checks, CodeQL and SonarCloud included.
+97
View File
@@ -0,0 +1,97 @@
# v4.4.0 – 2026-10-23 (The "Headroom" Edition)
[All versions](../../../CHANGELOG.md)
The data pipeline grows with the catalogue again. With almost 10,000 games
and a few hundred more every day, the jobs that asked Steam about one game at
a time had run out of time; they now read Steam's store API fifty games a
request, wait their turn instead of cancelling each other, and stop in time to
save. The release also carries the tooling merged since v4.3.3 - TypeScript
7, Node 26 and Python 3.15, SonarCloud in CI, the desktop updater fix - and a
certifi bump. The desktop and Android apps stay at `2.2.1`, with no new
build. Repo public-facing version `4.3.3` → `4.4.0`.
## 🧰 Pipeline
- **The data jobs scale with the catalogue again.** With almost 10,000 games
and a few hundred more every day, three jobs that asked Steam about one
game at a time had reached GitHub's six-hour limit: on 2026-10-23 Update
Reviews was stopped at exactly six hours with nothing saved. The full
assessment, with every measurement, is `docs/plan/18-pipeline-scale.md`.
- **Reviews come from Steam's store API, for every game, every day.** Fifty
games a request, about two minutes for the catalogue, instead of every two
days and five and a half hours. The percentage is now Steam's own, which
rounds down: about 4,000 games show one point less once (Counter-Strike 2
"85%" instead of "86%"), exactly as on their store pages. A summary that
says 0 reviews is double-checked game by game before it replaces a
percentage.
- **New games get their reviews again.** Steam's per-game reviews endpoint
has answered with a redirect to the store front since 2026-10-23, so the 38
games added that day were listed with "N/A". A new game now takes its
summary from the store API when that endpoint gives none, and a game never
read becomes "No reviews" until Steam counts its first one.
- **The daily purge needs two answers to remove a game.** Steam's store API
screens every game in a few minutes, and a game is removed only when
appdetails agrees; "unavailable" is asked twice, five minutes apart. A run
that would remove more than 100 games, or flags more than 500, stops before
writing anything. It also lists earlier removals that Steam has since
undone. It runs daily now, instead of a five-hour sweep on Mondays.
- **Check Dead Links is retired.** In its whole life it never found a dead
link: Steam sends a delisted game's page to the store front, which answers
200. The purge's screen sees delisted games (`unlisted`) instead.
- **No run is cancelled for waiting.** The data jobs share one queue that
used to hold a single waiting run: a third job cancelled it, and Update
Reviews lost five of ten runs that way. The queue now holds them all, first
in, first out, and every job checks out the latest `main` when it starts -
Auto Update JSON failed four days in ten from working on the data as it was
when the run was queued.
- **Every long job stops in time to save.** Each workflow gives its job a time
budget below its timeout: past it the job saves and commits what it did
instead of being stopped with nothing, and it warns before the budget gets
tight. The leaderboards skip the pauses meant for store pages (Top Online
~27 minutes instead of 48). The store-data and all-time-peak rotations
stretch their cycle as the catalogue grows instead of their daily runs.
- **Force Re-fetch runs in parts** (`1/8` … `8/8`, queued one after another),
and a game whose fetch fails keeps its old data.
## 🧰 Tooling
- **Desktop releases keep reaching the updater.** tauri-action v1 writes each
file's API address into `latest.json`, which the app's update check refuses,
so desktop 2.2.1 had to be fixed by hand before installed apps were offered
it. A new step of the release workflow now rewrites those addresses to the
release's own downloads, checking every signature on the way.
- **SonarCloud reads tests as tests**, and no longer analyses the dataset,
the Android resources the Tauri CLI generated, or the SQLite migrations its
PL/SQL analyser misread.
- **SonarCloud analyses in CI.** A workflow runs the scan on pull requests and
on `main` in place of SonarCloud's automatic analysis, with its settings in
`sonar-project.properties` (formerly `.sonarcloud.properties`). Commits that
only carry data are not scanned. It runs both test suites with coverage
first (pytest-cov for the pipeline, `npm run test:coverage` for the web
app), so SonarCloud shows what the tests reach instead of reading 0%.
- **TypeScript 7, Node 26 and Python 3.15.** The type-check runs on
TypeScript 7, the native compiler: `tsc` for the Worker, the tests and the
admin's Node code, and `svelte-check --tsgo` for the app. TypeScript 6 stays
installed beside it, because svelte-check and SvelteKit's route types still
need the JavaScript API that 7.0 does not have (the admin's svelte-check
stays on it too). CI, the release builds and Cloudflare's build run Node 26,
the LTS from 28 October; the pipeline, its tests and every data job run
Python 3.15, which writes the shards byte for byte as 3.12 did - no
re-download for anyone. The leaderboards and the dead-link log name their
encoding, so they no longer crash on Windows under an older Python. A new
test fails when one of the version pins drifts from the others, and Web CI
now runs on workflow-only changes so it sees them. The full assessment is in
`docs/plan/16-toolchain-2026.md`; `docs/plan/17-typescript-7.1.md` prepares
the move to TypeScript 7 alone once 7.1 is out.
## 🔐 Security
- **certifi 2026.10.19** (GHSA-6q48-6c7w-9gw2), the CA bundle behind every
HTTPS request the pipeline makes. eMudhra's `emSign ECC Root CA - G3` had
intermediates whose private keys were compromised; certifi 2026.10.18 - the
version pinned here - had already dropped every emSign root, and 2026.10.19
puts back the three that are not affected (G1, C1, ECC C3) while G3 stays
out. So the pipeline was never trusting the bad root, but the advisory's
range covered 2026.10.18 and pip-audit flagged it; the lock now names the
fixed release, with its hashes.
+55
View File
@@ -0,0 +1,55 @@
# v4.4.1 – 2026-10-26 (The "Tune-Up" Edition)
[All versions](../../../CHANGELOG.md)
A dependency and security pass. The desktop and Android apps take the
patched TLS stack their updater talks to the release server with; the dev
tooling, the Python pipeline and the CI workflows catch up with their
fixes. Nothing changes in how the site or the apps look or behave. Desktop
and Android bumped `2.2.1` → `2.2.2`; repo public-facing version `4.4.0` →
`4.4.1`. The desktop app offers 2.2.2 through its updater once the release
is published; on Android, install the new APK over the old one.
## 🔐 Security
- **The apps' TLS stack is patched.** rustls 0.23.46 closes four advisories,
among them an unauthenticated ServerHello that could downgrade later
connections to classical key exchange; rustls-webpki 0.103.16 and
webpki-root-certs 1.0.11 stop accepting certificates chained to the
distrusted emSign intermediates. In the apps this is the HTTPS the updater
checks for, and downloads, a new version over.
- Also in the apps: tokio, anyhow and event-listener (soundness fixes) and
plist 1.10, whose quick-xml 0.42 closes two denial-of-service advisories.
Still waiting on Tauri: the zip 4 inside its updater plugin (three
extraction advisories; the updater checks every download's signature
before it opens it), the Linux GTK 3 bindings (glib 0.18) and the
unmaintained proc-macro-error, zbus_names and zvariant. They go when Tauri
moves.
- Dev tooling: undici 7.30.1 inside wrangler's local simulator (three
advisories; it runs in `wrangler dev` and the deploy check, never in the
deployed Worker), zod 4.6.7 (in the unused-code report).
- Two SvelteKit advisories are fixed only in SvelteKit 3 and need code this
site does not have - a prerendered page forwarding an untrusted
`cache-control` to `setHeaders`, and `use:enhance` form actions - so they
are dismissed as not applicable. The move to SvelteKit 3 is a migration of
its own.
## 🧹 Changed
- Pipeline: certifi 2026.10.23 (the CA bundle the scrapers verify Steam
with), coverage 7.17.0 for the tests, both pinned with their hashes.
- Site and apps: bits-ui 2.20.2, Lucide 1.61.0, TanStack Virtual 3.13.48,
Vite 8.3.5; tooling: wrangler 4.152.0, knip 6.43.0, Tauri CLI 2.12.4.
- Merged by Dependabot since v4.4.0 and first shipped in these apps: Tauri
2.12.4; in the build tooling, fast-uri 3.1.9 and serialize-javascript 7.1.4
(two advisories).
- CI: every workflow runs on `actions/checkout` v6 and `actions/setup-python`
v6. The data jobs still on the Node 20 majors printed a deprecation warning
on every run. The release workflows take rust-cache 2.9.3.
## 📚 Docs
- `CLAUDE.md`: the undici override and when to delete it; why SvelteKit
stays on 2 and what would make the two advisories apply again.
`.github/dependabot.yml`: why checkout and setup-python majors are taken by
hand, for every workflow at once.
+38
View File
@@ -0,0 +1,38 @@
# v4.5.0 – 2026-10-26 (The "Groundwork" Edition)
[All versions](../../../CHANGELOG.md)
The site and the apps move to SvelteKit 3, the framework every page is
built on. Nothing about how they look or work should change: every page,
the Content-Security-Policy and the offline cache were compared with a
SvelteKit 2 build of the same commit before the switch. The apps also take
Tauri 2.12.5. Desktop and Android bumped `2.2.2` → `2.3.0`; repo
public-facing version `4.4.1` → `4.5.0`. The desktop app offers 2.3.0
through its updater once the release is published; on Android, install the
new APK over the old one.
## 🧹 Changed
- **The site and the apps build on SvelteKit 3** (3.1, with adapter-static
4). Nothing changes for readers: the same pages with the same text, the
same Content-Security-Policy and the same service-worker precache, each
checked against a SvelteKit 2 build of the same commit. SvelteKit 3 refuses
`svelte.config.js`, so its options moved to `web/build/sveltekit-config.ts`,
now with tests for both the web and the app policies; `$lib` imports became
`#lib`, and the `/legal/<slug>` matcher moved to `web/src/params.ts`.
- The service worker is wired into the build by `web/build/pwa.ts`, on
vite-plugin-pwa: `@vite-pwa/sveltekit` never supported SvelteKit 3.
- An old `/#/…` link to a page that no longer exists now opens the "Page not
found" page (`/error/404`); SvelteKit 3 refuses to navigate to it in place.
One that names another site (`/#//other.example/…`) is ignored.
- SvelteKit now asks the site for its version (`/_app/version.json`, a few
bytes) when a tab regains focus and once an hour, where it used to ask only
after a navigation failed. A newer deploy still changes nothing until a
navigation fails, which then reloads the page, as before.
- The desktop and Android apps take Tauri 2.12.5 (tauri-build 2.7.4).
## 🔐 Security
- The two SvelteKit advisories dismissed in v4.4.1 (GHSA-27mw-82g8-phjj,
GHSA-pfhg-q3qv-9q6r) are fixed by the upgrade, and `npm audit` reports
nothing: the `cookie` override SvelteKit 2 needed is gone.
+43
View File
@@ -0,0 +1,43 @@
# v4.5.1 – 2026-10-27 (The "Speed Bump" Edition)
[All versions](../../../CHANGELOG.md)
The site's Worker now limits how fast one address can call it, behind
Cloudflare's own rate-limiting rule at the edge. Nothing changes for readers,
the apps or the pipeline: every limit sits far above what they send. The
desktop and Android apps stay at `2.3.0`, with no new build. Repo
public-facing version `4.5.0` → `4.5.1`.
## 🔐 Security
- **Rate limits in the Worker, one budget per surface.** Per address and per
minute: the catalogue API 240 requests (loading the whole catalogue takes
about 16), the image proxy 600, the other public API routes 120, the human
check 20 (a person sends one a day) and the admin surface 300. Past a limit
the Worker answers `429 Too Many Requests` with `Retry-After: 60` until the
minute is up; the apps can read that answer, where they would otherwise have
seen a network error. An IPv6 address counts by its /64, the block one
subscriber is normally given. Cloudflare keeps these counts per server, so
they stop a client that keeps its connection open, as browsers and most
scripts do; one that reconnects for every request is left to the edge rule,
which counts exactly. They are ceilings for abuse, never quotas. The limits
are bindings in `web/wrangler.jsonc` and change by pull request.
- **Two layers, the edge first.** The zone's rate-limiting rule still refuses
a burst before the Worker runs, at no cost, and is the only limit on the
pages themselves; the Worker adds the one-minute window the Free plan's
10-second rule cannot, and keeps holding if that rule is changed. If the
Worker's limiter is ever unavailable, requests go through rather than fail.
- The recommended edge rule now covers the whole site except the hashed
JavaScript and CSS bundles, at 250 requests per 10 seconds per address. That
is about twice what a first visit sends once the offline cache fills in
(counted from the build: 110 to 130 requests in a few seconds). Applying it
is a Cloudflare dashboard change, described in `docs/SECURITY_SETUP.md` §3a.
## 📚 Docs
- `docs/SECURITY_SETUP.md` §3 describes both layers, how to check each one
with `curl`, and the Free-plan rule budget as it stands (one of one rate
limiting rule, four of five custom rules).
- `CLAUDE.md` records the layer's rules: it fails open, is not logged, keeps a
60-second period and an account-unique `namespace_id` per binding, and needs
a budget for any prefix the Worker runs first for.
+67
View File
@@ -0,0 +1,67 @@
# v4.6.0 – 2026-10-30 (The "Polyglot" Edition)
[All versions](../../../CHANGELOG.md)
The catalogue now takes free games in every language, not only the ones
that support English: about 1,300 more, most of them Chinese, Japanese or
Korean, arrive through the review queue over the next days. The site and
the apps get a language filter, search that matches across scripts and
widths, and CSV files that Excel opens correctly; and 1,357 games filed under
"Free To Play" get a real genre. Desktop and Android
bumped `2.3.0` → `2.4.0`; repo public-facing version `4.5.1` → `4.6.0`.
The desktop app offers 2.4.0 through its updater once the release is
published; on Android, install the new APK over the old one.
## ✨ Added
- **Games in every language.** Discovery used to search Steam only for free
games that list English, which left out 1,592 of them: mostly Simplified
Chinese (784), Japanese (317), Korean (165) and Traditional Chinese (164)
only, the free Japanese visual novel `//トロイメライ・ノクターン` among them.
It now proposes every free game whatever its languages, and every release
window swept before gets one more pass. The pipeline still asks Steam in English, so
tags, genres and language names stay in English; a name or description the
developer never wrote in English stays in their language.
- **A language filter on Games**, counted like the others and part of the
link (`?lang=Japanese`), so a reader can keep to the languages they read.
The About page says the catalogue now covers every language.
- **Search across scripts and widths.** Every search box (Games, the command
palette, developers, publishers and the anti-cheat list) now matches
half-width and full-width forms and hiragana and katakana as one: `トロイ`,
`とろい` and `トロイ` find the same game, and `4` finds `4`. One kanji, kana
or Hangul syllable is enough in the command palette.
- `/admin` shows a candidate's languages, with a **No English** badge when
English is not among them. Such games are decided like any other.
## 🐛 Fixed
- The header search no longer jumps to Games in the middle of a word typed
with a Japanese, Chinese or Korean input method; it waits until the word is
chosen. And it keeps its focus when it does jump: until now the next letter
typed after the jump went nowhere, whatever the language.
- A CSV export opens in Excel with its Japanese, Chinese and Korean names
intact (it now starts with a byte order mark).
- A long Chinese or Japanese description is cut at the end of a sentence
where it can be, and never ends in `、…` or `。…`.
- **"Free To Play" is no longer a genre.** Steam spells it with a capital T,
the list of names never to use as a genre had a small one, and 1,357 games
were filed under "Free To Play" - the third most common genre, and one that
says nothing about a catalogue of free games. New games get their real
genre, and the daily store refresh gives the 1,357 theirs from Steam, 150 a
day (about nine days). A genre someone set by hand is never touched.
- A queued store link written in full-width digits (`5118700`) is read
as the appid it is; digits of any other script are refused. Such an appid
used to slip through, and the next daily refresh would have stopped on it.
The blocklist now accepts exactly the lines the site's own reader does.
## 🧰 Pipeline
- Discovery runs wait in turn: backfill windows dispatched together no longer
cancel each other, and a window can be swept a whole year at a time
(`max_pages`). Each run says how many candidates do not list English.
## 📚 Docs
- `docs/plan/19-all-languages.md`: what kept these games out, what every
workflow does with them, and what is left (games not sold in the US, CJK
fonts).
+39
View File
@@ -0,0 +1,39 @@
# v4.6.1 – 2026-10-31 (The "Zip Tie" Edition)
[All versions](../../../CHANGELOG.md)
A security pass. The desktop app's updater takes the patched zip reader
v4.4.1 had to leave waiting on Tauri, and the service-worker build takes
patched glob and minimatch. Nothing
changes in how the site or the apps look or behave. Desktop and Android
bumped `2.4.0` → `2.4.1`; repo public-facing version `4.6.0` → `4.6.1`.
The desktop app offers 2.4.1 through its updater once the release is
published; on Android, install the new APK over the old one.
## 🔐 Security
- **The desktop updater's zip reader is patched.** tauri-plugin-updater
2.14.1 moves from zip 4 to zip 9.2, which closes six advisories in how an
archive is read and extracted, one of them critical: two headers in one
archive that disagree, so whatever checks an archive and whatever unpacks
it could see different files. The others are symlinks pointing out of the
destination, setuid bits and permissions carried through symlinks, an
unbounded symlink target, and an AES entry accepted without its
authentication code. The updater opens a zip only on Windows, and only
after it has checked the download's signature, so a forged archive never
reached it. Still waiting on Tauri: the Linux GTK 3 bindings (glib 0.18) and the unmaintained
proc-macro-error, zbus_names and zvariant.
- Build tooling: glob 14.0.3 and minimatch 11.0.3 in the service-worker
build, two moderate advisories published on 2026-10-30 (an aborted walk
that kept reading directories, and patterns that could take exponential
time). Only this repository's own patterns reach them, at build time; the
service worker precaches exactly the same 172 URLs as before.
- deepmerge, used by the Svelte and rollup plugins to merge their own
configuration at build time, has a low advisory with no fixed release. It
never ships to the site, the Worker or the apps, and the alert is
dismissed as a tolerable risk.
## 📚 Docs
- `CLAUDE.md`: the glob and minimatch overrides, why they are safe and when
to delete them; the undici override can go with wrangler 4.156.0.
+55
View File
@@ -0,0 +1,55 @@
# v4.7.0 – 2026-11-03 (The "Lucky Dip" Edition)
[All versions](../../../CHANGELOG.md)
Two small additions. A Random games page picks up to five games from the
catalogue when you cannot decide what to play, and the first-run terms screen
gets a way out: on the website, "Leave site" takes you back to the page you
came from; in the apps, Decline now quits, which on Android it never did. No
legal document changed, so nobody is asked to accept the terms again. Desktop
and Android bumped `2.4.1` → `2.5.0`; repo public-facing version `4.6.1` →
`4.7.0`. The desktop app offers 2.5.0 through its updater once the release is
published; on Android, install the new APK over the old one.
## ✨ Added
- **Random games.** `/random`, in the sidebar, the menu and the command
palette, with a dice button on the dashboard, rolls one to five games (five
to start with): online, offline or either, dead games only when you ask for
them, and never one marked unsafe. Roll again for a set that avoids the
games on screen; a smaller count keeps the first ones, a larger one adds to
them. Opening a game and coming back keeps the picks, and nothing is
stored: a reload rolls anew.
- **Leave site**, on the first-run terms screen and on the notice after
Decline (website only). A page may not open the browser's own start page,
so it goes back to the page before the site - the new-tab page when you
typed the address there, the search results when you came from a search -
past every page of the site you opened in between. When the site is the
first page in its tab, it says so and offers to close the tab; that takes a
second click, because closing the last tab closes the browser window too.
## 🐛 Fixed
- Declining the terms quits the Android app. It did nothing at all: the app
asked its window to close, which does nothing on Android. Both apps now quit
through Tauri's own exit, and the declined notice appears if an app is ever
still open afterwards. The apps also drop a permission nothing uses any more
(closing a window from script) for the one quitting needs.
## 🧰 Tooling & misc
- Dependencies: SvelteKit 3.1.1 and adapter-static 4.0.1, Svelte 5.57.3,
the Tauri shell plugin 2.6.0 (JavaScript and Rust together) and
single-instance 2.5.5, the updater's JavaScript side 2.14.1 (its Rust side
already was), wrangler 4.156.0, pytest 9.2.0 and the SonarCloud scan
action 8.4.0, plus patch releases of the icon, toast and virtual-list
libraries. No security advisory among them; nothing changes in how the
site or the apps behave.
- The undici override is gone: wrangler 4.156.0's local simulator pins the
patched undici 7.30.1 itself.
## 📚 Docs
- `CLAUDE.md`: how `/random` rolls and why it stores nothing; how Leave site
finds the page before the site, and why Decline quits through `exit()`.
- Both READMEs list the random page and its modules.
+99
View File
@@ -0,0 +1,99 @@
# v4.7.1 – 2026-11-09 (The "Curb Cut" Edition)
[All versions](../../../CHANGELOG.md)
An accessibility release. The repository gains an accessibility statement
that says honestly what works with a keyboard, a screen reader and zoom, and
what does not yet. The worst barriers it found are fixed:
- the games table is a real table to a screen reader;
- the first-run screens hold the keyboard focus;
- kernel-level anti-cheat is no longer told apart by colour alone;
- both themes meet the contrast WCAG asks for;
- the desktop app zooms.
Like a curb cut, most of it helps everyone. The community docs were also
brought back in line with the repository. No legal document you accept
changed, so nobody is asked to accept the terms again.
Desktop and Android go from `2.5.0` to `2.5.1`, and the repo's public version
from `4.7.0` to `4.7.1`. The desktop app offers 2.5.1 through its updater once
the release is published. On Android, install the new APK over the old one.
## ✨ Added
- **An accessibility statement.** `ACCESSIBILITY.md` says what works today
with a keyboard, a screen reader and zoom, and what does not work yet: the
games table, most charts, the first-run screens, zoom in the apps. It also
lists which browsers and apps are checked by hand, and how a report is
handled. GitHub shows it as the repository's Accessibility tab. Barriers get
their own issue form and an `accessibility` label, and the About page links
the statement and the form.
- A pull request template covering what and why, the checks to run, and a
short accessibility list for interface changes.
## 🐛 Fixed
- The About page's stack list said SvelteKit 2 and counted 3,600 rows. Its
footnote said everything the page loads comes from this site, which is not
true of Cloudflare's beacon and human check. It now says what is true: the
game data and art come from this site. The Vietnamese AI note gains the
sentence it was missing.
- Source archives (`git archive`, GitHub's "Source code" downloads) left out
three legal documents that the web build reads, so building from one
stopped. They are included now.
- **Accessibility**, on the website and in the apps from 2.5.1:
- **The games table** is now a table to a screen reader. It exposes its
roles, the row and column counts, and a position for every row, even
though only the rows on screen exist. The image, data-issue and Steam
columns have names.
- **Table rows** are no longer a link wrapped around another link, and each
row is one <kbd>Tab</kbd> stop instead of two. Clicking anywhere on a row
still opens the game.
- **The phone cards** are a list that tells a screen reader its length and
each card's position.
- **The terms screen and the human check** are dialogs that take focus, and
the page behind them is out of reach until you are through. Before, Tab
walked through the hidden page first, and Ctrl/⌘+K could open the
command palette underneath them, out of sight but holding focus.
- **Kernel-level anti-cheat** shows a shield icon and the words, not only a
red badge.
- **Contrast:**
- Light-theme links, primary buttons, warnings and badges reach 4.5:1.
The light theme's amber is a shade darker as a result.
- Red badges in the dark theme reach 4.5:1 too.
- Text boxes and drop-downs have a visible 3:1 edge in both themes.
- **Zoom:**
- The games list keeps a minimum height when zoomed in, instead of
shrinking to nothing at 300-400%.
- The desktop app zooms with Ctrl/⌘ and + / −.
- **Smaller fixes:**
- "Back to top" is out of the Tab order while it is hidden, and jumps
instead of gliding when *reduce motion* is on.
- The command palette's search box shows a focus ring.
- Screen readers read out the 💀 and the table's warning icon as words.
- `ACCESSIBILITY.md` moves all of this from "Known limitations" to "What
works today".
## 🧰 Tooling & misc
- `web/src/lib/a11y.test.ts` holds those fixes in the code. It also computes
the theme's contrast with the WCAG formula, so a colour edit that drops
below 4.5:1 for text, or below 3:1 for a control's edge, fails the tests.
## 📚 Docs
- The community docs match the repository again:
- **README:** live game-count and version badges, SvelteKit 3, every desktop
package, the shard layout, the workflows its table left out, and which
commits deploy.
- **SECURITY.md:** the real stack, pushes with the built-in token, and the
media host and the ingest and update endpoints in scope.
- **AUTHORS.md, `username.txt`, CONTRIBUTING.md and the code of conduct.**
- **The issue forms:** the hash links, GitHub Pages permalinks and the
editing and GPG options are gone. The version is under the title, not
behind a hover.
- **`web/README.md`, `docs/dev_env.md` (EN + VI), the acknowledgements and
the contact page.** Neither of the last two is a document you accept, so
nobody is asked to accept the terms again.
- `CLAUDE.md`: `ACCESSIBILITY.md` is a claim about the code, kept true in the
same pull request, and the rules behind the accessibility fixes.
+88
View File
@@ -0,0 +1,88 @@
# v4.7.2 – 2026-11-17 (The "Steady State" Edition)
[All versions](../../../CHANGELOG.md)
The first release in maintenance mode, and a security one. The project is
stable: from here it is kept running rather than extended, and issues and
pull requests are for the data. This release takes that to the apps, with:
- rustix 1.1.6 in the desktop and Android shell, for RUSTSEC-2026-0486,
which Dependabot never raised;
- JetBrains Qodana next to CodeQL and SonarCloud, and what its first run
found, fixed;
- two weeks of dependency updates.
Nothing changes in how the site or the apps look or behave, apart from the
About page's report links. No legal document you accept changed, so nobody
is asked to accept the terms again.
Desktop and Android go from `2.5.1` to `2.5.2`, and the repo's public version
from `4.7.1` to `4.7.2`. The desktop app offers 2.5.2 through its updater once
the release is published. On Android, install the new APK over the old one.
## 🔐 Security
- The desktop and Android shell takes rustix 1.1.6, which fixes
[RUSTSEC-2026-0486](https://rustsec.org/advisories/RUSTSEC-2026-0486.html):
its extended-attribute calls could mark memory as written that the system
never wrote, when handed an empty buffer. Those calls are reachable through
the updater's archive code (tar, then xattr). Dependabot raised no alert
for it; the weekly OSV check of `Cargo.lock` found it. Only the lockfile
changes (rustix's entry alone).
## 🧊 Stable: maintenance mode (2026-11-11)
The project does what it set out to do, so from here it is kept running
rather than extended. Nothing changes for readers: the pipeline still
refreshes the list every day, and the site and the apps stay up.
- **No new features.** Code changes only for security advisories, runtime and
dependency updates, and whatever those break.
- **Issues and pull requests are for the data.** Two new forms, **Add games**
and **Edit game**, join **Delete games**; **Bug report** and
**Accessibility barrier** stay for things that are broken. The feature
request, feedback and off-topic forms are gone, blank issues are off, and
the chooser sends questions to Discussions and vulnerabilities to private
reporting.
- The About page's "Report something" links follow: add, correct, remove,
bug, accessibility. The apps take the new links with 2.5.2; 2.5.1 still
links the old feature form, which now opens the form chooser.
- README: a status badge, build badges (Web CI, Python Tests, CodeQL,
SonarCloud gate and coverage), live desktop and Android version badges, and
the licences and runtimes. CONTRIBUTING, SECURITY, the pull-request
template and CLAUDE.md state the same policy.
- No legal document you accept changed, so nobody is asked to accept the
terms again.
## 🔍 Code analysis: Qodana
- JetBrains Qodana now checks every pull request and every change to `main`,
next to CodeQL and SonarCloud, as three Qodana Cloud projects: Python for
the data pipeline, JavaScript/TypeScript and Svelte for the site, the admin
pages and the Worker, and Rust for the desktop and Android shell. Any
problem fails the check; what each part leaves out on purpose is listed,
with the reason, in its `qodana.yaml`.
- Its first findings are fixed, none of them a change in behaviour: tidier
returns, docstrings and names in the pipeline, the leaderboards' catch-all
`except:` narrowed to the errors a review string can raise, an unused
import, two simpler regular expressions; two comma expressions, a trivial
`if` and read-only fields in the web code; and `serde`, a crate the app
shell declared and never used.
- Data commits and Markdown-only changes are not scanned. Nothing changes
for readers.
## 🧰 Tooling & misc
- Dependencies: patch releases of the icon, dialog, toast and virtual-list
libraries (Lucide 1.70.0, bits-ui 2.20.6, svelte-sonner 1.2.3, TanStack
Virtual 3.13.52), Tailwind CSS 4.3.5, Vite 8.3.6, Vitest 5.1.0,
svelte-check 4.7.8, wrangler 4.158.0, coverage 7.17.2, and the release and
SonarCloud scan actions (3.0.4, 8.4.1). No security advisory among them,
and nothing changes in how the site or the apps behave.
- Dependencies, a week later: Lucide 1.72.0, bits-ui 2.21.0, Vite 8.3.8,
wrangler 4.162.0, rollup-plugin-visualizer 7.1.3, knip 6.45.1, coverage
7.17.3 and the SonarCloud scan action 8.5.0. knip 6.45 reads
`tsconfig.json`'s `extends` and reported `$app` (the config
`svelte-kit sync` generates) as a missing dependency, which failed CI; its
`ignoreDependencies` cannot match a name that starts with `$`, so
`knip.json` now ignores unlisted dependencies in `tsconfig.json` alone.
Again no advisory and no change in behaviour.
+800 -800
View File
File diff suppressed because it is too large. Load diff
+800 -800
View File
File diff suppressed because it is too large. Load diff
+800 -800
View File
File diff suppressed because it is too large. Load diff
+800 -800
View File
File diff suppressed because it is too large. Load diff
Loaded 100 of 357 files, more files were not shown because too many files have changed in this diff. Show more