Compare commits

...
1569 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
poli0981 8a06201088 Merge pull request #192 from poli0981/fix/code-scanning-sonar
v4.3.3: CodeQL #20 and SonarCloud findings (CI pinning, linear parsers, Android backup)
2026-10-19 09:37:30 +07:00
poli0981andClaude Opus 5.5 d56d423876 docs: SonarCloud analyses pull requests too
The previous commit said SonarCloud's automatic analysis covers main only.
That was read from an empty pull-request list at a moment when no PR was
open; this PR got its own "SonarCloud Code Analysis" check (quality gate
passed, no new issues). DEPLOYMENT.md and the CHANGELOG entry now say that
CodeQL and SonarCloud both check pull requests and main.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:35:50 +07:00
poli0981andClaude Opus 5.5 9cd5450613 release: v4.3.3 - The Locksmith Edition (desktop/android 2.2.1)
Repo public-facing version 4.3.2 -> 4.3.3; web app + desktop/Android
2.2.0 -> 2.2.1 (package.json and its lock, Cargo.toml and the f2p-tracker
entry of Cargo.lock, tauri.conf.json). The apps also pick up the Contact
page, the reworded anti-cheat paragraphs of the Disclaimer and the Terms
(consent gate shown once) and v4.3.2's anti-cheat grouping.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:32:18 +07:00
poli0981andClaude Opus 5.5 5247a3d3b3 docs: CI pinning rules, the worker's origin check, Android backup
- CLAUDE.md: the parser worker's origin check and why `e.origin &&` must
  stay; CI installs only what is pinned (action SHAs, --ignore-scripts, no
  npx, hashed Python requirements and how to add a package); the Android
  app's Auto Backup opt-out and why the policy is not the thing to change.
- docs/DEPLOYMENT.md: what web-ci and python-tests run now; CodeQL analyses
  pull requests, SonarCloud only main.
- docs/dev_env.md (and docs/i18n/vi): run the pipeline from the repo root
  with the hashed installs - `cd scripts` left data/ out of reach.
- docs/THIRD_PARTY.md: requirements-dev.txt goes in a pip call of its own.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:32:11 +07:00
poli0981andClaude Opus 5.5 79d9df4bb4 fix(android): opt out of Auto Backup
The manifest never set android:allowBackup, so it defaulted to true and
Android copied the WebView's storage (consent, settings, the cached
catalogue) into the user's Google account backup, while the Privacy Policy
says none of it leaves the device (SonarCloud xml:S6358). The app now says
allowBackup="false"; the policy stays as it is. No library manifest of the
build (tauri, its plugins, AndroidX) declares the attribute, so the manifest
merge has nothing to reconcile.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:32:11 +07:00
poli0981andClaude Opus 5.5 dfeefeb330 fix(web): act on SonarCloud's findings in web/
- Regexes that backtracked quadratically (typescript:S8786) are linear:
  chart colour tokens (trimmed, no \s* at the ends), the review percentage
  (up to three digits, from the start of a run) and label ([^()]+), the
  legal pages' title, the admin router's trailing slashes and the image
  route's capsule path (both without a regex), base64url padding
  (replaceAll; "=" is only ever trailing) and the admin mock. Checked
  against the old forms on random input: the percentage and the colours
  agree everywhere, the label and the title only differ on nested
  parentheses and blank "#" lines, which no summary or document has.
  New utils.test.ts pins the review parsing.
- Bare .sort() on strings (typescript:S2871) becomes .sort(byCodeUnit), a
  new shared/sort.ts that states the code-unit order those lists always had.
  Not localeCompare: the admin build id hashes this order. The sitemap is
  byte-identical.
- Number.parseInt / Number.parseFloat / Number.NaN (typescript:S7773).
- admin.css puts its @imports before @source (css:S8778); the emitted
  stylesheet is byte-identical.
- The raw U+FEFF inside removal.ts's split regex is written as an escape.
- normalizeLink, exported and called from nowhere, is removed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:32:00 +07:00
poli0981andClaude Opus 5.5 d8991dada4 fix(pipeline): act on SonarCloud's findings in scripts/
- Linear parsers (python:S8786): the store page's "unsupported" language
  rows and its tags, and the discovery sweep's search rows, no longer use
  regexes that backtrack quadratically on long input. New tests, written
  against the old regexes first, pin what they read, and a differential
  fuzz (200,000 random inputs) found no case where old and new disagree.
- Raw invisible and bidi characters in normalize.py and two test files are
  written as escapes (text:S6389); every string value is unchanged.
- scrape_store_fields() states when there is no usable page (scraped = None)
  instead of deriving it into a separate flag (pythonbugs:S2259).
- cmd_list() in delete_game.py and edit_game.py returns nothing; the
  dispatch returns 0 (python:S3516). remove_games.main() keeps its int:
  delete_game.py and its tests use the exit code.
- The Steam client mounts its retrying adapter for https only
  (python:S5332); nothing is fetched over http.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:31:48 +07:00
poli0981andClaude Opus 5.5 988e4f4ce6 ci: pin third-party actions, install without lifecycle scripts, hash Python deps
SonarCloud's GitHub Actions and shell findings, all supply-chain hardening
for jobs that hold a write token (and, in the release workflows, the
signing keys):

- The six third-party actions in release-desktop.yml and release-android.yml
  are pinned to the commit their major tag points at today, with the version
  in a comment for Dependabot. dtolnay/rust-toolchain is pinned to a master
  commit and given `toolchain: stable`: its `stable` branch is regenerated
  on top of master, so a commit of it can vanish.
- Every `npm ci` is `npm ci --ignore-scripts`. Only fsevents, workerd and
  wrangler's esbuild have install scripts; the last two find their binary in
  their optional platform package without them, and fsevents is only file
  watching. `npx` is gone from the workflows (`npm run cf:check`,
  `npm test -- <file>`).
- requirements.txt pins every runtime package, transitive ones included
  (certifi, charset-normalizer, idna), with the sha256 of every file on
  PyPI; every install is `--require-hashes --only-binary :all:`. The new
  requirements-test.txt holds pytest the same way. python-tests.yml runs the
  data jobs' exact install line first, so a Dependabot bump is proven before
  a data job meets it.
- `[[ ]]` instead of `[ ]` in the bash wrappers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:31:40 +07:00
poli0981andClaude Opus 5.5 790ab21225 fix(web): refuse a parser-worker message from another origin (CodeQL #20)
The catalogue's parser worker is a dedicated module worker: only the page
that created it can post to it, over its implicit port, and those messages
carry origin "". It now refuses any non-empty origin that is not its own,
replying with an error so a pending decode fails instead of hanging. This is
the check CodeQL's js/missing-origin-check looks for; the earlier dismissal
(#3) came back as #20 when the handler moved three lines.

`e.origin &&` is load-bearing (the owner's "" never equals
self.location.origin), and a test without `location` holds it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:31:32 +07:00
github-actions[bot] fd6c8946ef Ingest games [2026-10-19 01:51] 2026-10-19 01:51:54 +00:00
f2p-tracker-admin[bot] efe3455021 queue: 78 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 01:45:32 +00:00
github-actions[bot] 64bdb81cc1 Ingest games [2026-10-19 01:38] 2026-10-19 01:38:47 +00:00
f2p-tracker-admin[bot] 68023de6d7 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-19 01:30:27 +00:00
github-actions[bot] 9b1ffd7358 Auto update [2026-10-19] 2026-10-19 00:22:30 +00:00
github-actions[bot] ece286ed1c Ingest games [2026-10-19 00:02] 2026-10-19 00:02:58 +00:00
f2p-tracker-admin[bot] 328a979cdb queue: 29 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 00:00:26 +00:00
github-actions[bot] d4ba05cd33 Snapshot [2026-10-18] 2026-10-18 23:12:34 +00:00
github-actions[bot] 1086d94946 Refresh all-time peaks [2026-10-18] 2026-10-18 19:45:40 +00:00
github-actions[bot] 3daca61885 Refresh store data [2026-10-18] 2026-10-18 17:10:04 +00:00
github-actions[bot] 7b0cc9635d Top online [2026-10-18 03:58] 2026-10-18 03:58:27 +00:00
github-actions[bot] a46f6035dd Ingest games [2026-10-18 01:08] 2026-10-18 01:08:41 +00:00
f2p-tracker-admin[bot] 3996bfd1ab 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-18 01:00:28 +00:00
github-actions[bot] 3db14b4a3a Ingest games [2026-10-18 00:53] 2026-10-18 00:53:40 +00:00
f2p-tracker-admin[bot] 42d0a983a7 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-18 00:45:30 +00:00
github-actions[bot] 237cb2794c Ingest games [2026-10-18 00:38] 2026-10-18 00:38:41 +00:00
f2p-tracker-admin[bot] c1e01f7583 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-18 00:30:28 +00:00
github-actions[bot] 1385db1f6e Ingest games [2026-10-18 00:23] 2026-10-18 00:23:40 +00:00
f2p-tracker-admin[bot] 88264526ed 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-18 00:15:29 +00:00
github-actions[bot] eb49b3605a Ingest games [2026-10-18 00:08] 2026-10-18 00:08:34 +00:00
f2p-tracker-admin[bot] fd3723cadc 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-18 00:00:26 +00:00
github-actions[bot] a892d3c163 Snapshot [2026-10-17] 2026-10-17 23:11:53 +00:00
github-actions[bot] afe3a7ff94 Refresh all-time peaks [2026-10-17] 2026-10-17 19:44:07 +00:00
github-actions[bot] 59d1d8280b Refresh store data [2026-10-17] 2026-10-17 17:05:24 +00:00
github-actions[bot] 88b5290e0e Update reviews [2026-10-17] 2026-10-17 11:07:48 +00:00
github-actions[bot] b5ee9f4093 Ingest games [2026-10-17 01:08] 2026-10-17 01:08:30 +00:00
f2p-tracker-admin[bot] 8c3efbacd1 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-17 01:00:21 +00:00
github-actions[bot] 50020c0570 Ingest games [2026-10-17 00:53] 2026-10-17 00:53:37 +00:00
f2p-tracker-admin[bot] 691176e7a7 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-17 00:45:20 +00:00
github-actions[bot] 157c79e09d Ingest games [2026-10-17 00:38] 2026-10-17 00:38:31 +00:00
f2p-tracker-admin[bot] c6450b4916 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-17 00:30:21 +00:00
github-actions[bot] 450f95b2d9 Ingest games [2026-10-17 00:23] 2026-10-17 00:23:38 +00:00
f2p-tracker-admin[bot] cfb9073e4a 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-17 00:15:21 +00:00
github-actions[bot] 31670c3a57 Ingest games [2026-10-17 00:08] 2026-10-17 00:08:31 +00:00
f2p-tracker-admin[bot] 3cccc7d844 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-17 00:00:18 +00:00
github-actions[bot] 46b4eb01d1 Snapshot [2026-10-16] 2026-10-16 23:13:10 +00:00
github-actions[bot] 2443800e9e Refresh all-time peaks [2026-10-16] 2026-10-16 19:46:44 +00:00
github-actions[bot] d381b1b5a6 Refresh store data [2026-10-16] 2026-10-16 17:08:25 +00:00
github-actions[bot] ae4e49b8d9 Top online [2026-10-16 03:55] 2026-10-16 03:55:21 +00:00
poli0981 95fb35f23c Merge pull request #190 from poli0981/feat/anticheat-families
v4.3.2: seven more anti-cheat families, matched as whole words
2026-10-16 10:06:58 +07:00
poli0981andClaude Opus 5.5 b72848b32e release: v4.3.2 - The "Pigeonhole" Edition (apps unchanged, 2.2.0)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 10:04:54 +07:00
poli0981andClaude Opus 5.5 39e504fd7f feat(anti-cheat): seven more product families, matched as whole words
After v4.3.1 read every game's anti-cheat from Steam, 68 of the 159 named
ones fell in the charts' "Other" slice. Add the families Steam's
disclosures use most - ACE, Anti-Cheat Toolkit, CrackProof, HoYoKProtect,
NGS (Nexon Game Security), EA Javelin, SARD - to ANTI_CHEAT_PATTERNS and its
web mirror (+ ANTI_CHEAT_ENUM). "Other" drops to 35, all one-off names.

Both sides now match a key or a pattern only as whole words (_has_term /
hasTerm): "ace" is inside "faceit ac", "space" and "interface", and the
web's substring check also filed "vacuum" under VAC. No stored value moves
between existing families (checked over all 56 distinct values).

A stored label is never rewritten: the old raw name and the new key are the
same family. refresh_anticheat.py --dry-run against Steam: 0 games changed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 10:04:54 +07:00
github-actions[bot] 3d65fcd6ad Refresh anti-cheat [2026-10-16] 2026-10-16 02:48:08 +00:00
poli0981 deb89fc796 Merge pull request #187 from poli0981/fix/anticheat-disclosure
v4.3.1: anti-cheat from Steam's own disclosure, extension retired
2026-10-16 09:41:14 +07:00
poli0981andClaude Opus 5.5 8990504b6c release: v4.3.1 - The "Fair Play" Edition (apps unchanged, 2.2.0)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 09:39:01 +07:00
poli0981andClaude Opus 5.5 7449489519 docs: anti-cheat is the developer's declaration on Steam; the extension is archived
- DISCLAIMER section 5 and ToS item 5: anti-cheat is read from the
  anti-cheat disclosure on the Steam store page, which the developer fills
  in; an undeclared one shows "-", and a declaration can be wrong. Both are
  consent documents: the web gate shows these two diffs once.
- README, CONTRIBUTING, Contact (shown at /legal/contact, not
  consent-gated): no more extension; a missing game or a correction goes in
  Discussions > Ideas; the manual fork path queues store links only.
- CLAUDE.md: the anti-cheat sweep and its rules, the trio as the one manual
  set a writer replaces (an override still wins), OverrideGuard, links-only
  queue, clean_notes, the pattern mirror; 15 data writers.
- ADMIN, dev_env (+vi), web/README: the extension is no longer a producer.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 09:38:50 +07:00
poli0981andClaude Opus 5.5 3d0e22cd76 fix(pipeline): read anti-cheat from Steam's own disclosure; retire the extension's paths
None of the 4,704 games added since September had an anti-cheat. The only
code that read the anti-cheat a developer declares on Steam was the browser
extension (archived; last push 2026-06-25); the pipeline matched appdetails'
categories, which only ever say "Valve Anti-Cheat enabled".

- core/anticheat.py (new, pure): the store page's div.anticheat_section
  (its HEADING decides kernel, never the class; a Boot Protection row is a
  flag) and GetItems' extra_details.anticheat; labels from
  ANTI_CHEAT_PATTERNS, else Steam's name cut at 40 characters; same_family()
  ("EAC" = "Easy Anti-Cheat", "ACE" = "Anti-Cheat Expert (ACE)"); and
  apply_anti_cheat(), the one rule.
- fetch_full() fills, never replaces, from the page it already fetches (or
  GetItems for a gated page), else the VAC category, now found in any
  position (with a stored "" only the first category was checked).
- refresh_anticheat.py (new): GetItems for every game (~160 requests), a
  store page only for a disclosure without a name. Steam wins; an override
  wins over Steam and is not fought (OverrideGuard); no disclosure never
  clears; a failed batch is unknown. Runs at the end of the daily Refresh
  Store Data job with its own commit; only=anticheat runs it alone. That job
  now checks out main.
- The queue takes links only: merge_extension_data(), EXTENSION_FIELDS,
  ARRAY_FIELDS and the schema.ts mirrors go. translate_notes() becomes
  clean_notes(): the extension's leading "Has paid DLC" and "[hover-add]"
  are dropped (517 notes, once, never news).
- refetch_all.py keeps "-" instead of resetting it to ""; a retired override
  whose was equals its value no longer bumps last_updated on every save.
- "denuvo" joins Denuvo AC on both sides; anti-cheat.test.ts holds the TS
  patterns and enum to constants.py.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 09:38:39 +07:00
github-actions[bot] 9fc8be83ad Ingest games [2026-10-16 01:08] 2026-10-16 01:08:55 +00:00
f2p-tracker-admin[bot] 28e3d057d6 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-16 01:00:45 +00:00
github-actions[bot] ac2c61da42 Ingest games [2026-10-16 00:53] 2026-10-16 00:53:55 +00:00
f2p-tracker-admin[bot] 32d69104f2 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-16 00:45:39 +00:00
github-actions[bot] 33a0665b37 Auto update [2026-10-16] 2026-10-16 00:42:43 +00:00
github-actions[bot] 46b3366bb5 Ingest games [2026-10-16 00:38] 2026-10-16 00:38:51 +00:00
f2p-tracker-admin[bot] 415aacbd19 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-16 00:30:38 +00:00
github-actions[bot] 0a295bf558 Ingest games [2026-10-16 00:23] 2026-10-16 00:23:54 +00:00
f2p-tracker-admin[bot] 778a8339d5 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-16 00:15:40 +00:00
github-actions[bot] 44107e6c1b Ingest games [2026-10-16 00:08] 2026-10-16 00:08:55 +00:00
f2p-tracker-admin[bot] 8785578179 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-16 00:00:36 +00:00
github-actions[bot] 484b90c6ac Snapshot [2026-10-15] 2026-10-15 23:12:28 +00:00
github-actions[bot] c6c93b5b78 Refresh all-time peaks [2026-10-15] 2026-10-15 19:43:54 +00:00
github-actions[bot] fd955b2a68 Refresh store data [2026-10-15] 2026-10-15 17:04:25 +00:00
github-actions[bot] bd6347ee5f Top offline [2026-10-15 06:37] 2026-10-15 06:37:51 +00:00
github-actions[bot] f2911e8261 chore(data): mark dead games 2026-10-15 04:39:08 +00:00
github-actions[bot] 1bd4c3d9d4 Ingest games [2026-10-15 03:30] 2026-10-15 03:30:39 +00:00
f2p-tracker-admin[bot] 5047b43ea4 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-10-15 03:30:16 +00:00
github-actions[bot] eddcd0cd6d Ingest games [2026-10-15 03:23] 2026-10-15 03:23:32 +00:00
f2p-tracker-admin[bot] 8c152de9a4 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-15 03:15:12 +00:00
github-actions[bot] 1a5d372e82 Auto update [2026-10-15] 2026-10-15 02:00:03 +00:00
github-actions[bot] 2ca4005c5d Ingest games [2026-10-15 00:53] 2026-10-15 00:53:18 +00:00
f2p-tracker-admin[bot] d9ca13021e queue: 98 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-15 00:45:14 +00:00
github-actions[bot] e9ca0104a7 Ingest games [2026-10-15 00:38] 2026-10-15 00:38:21 +00:00
f2p-tracker-admin[bot] f7e61a83c5 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-15 00:30:14 +00:00
github-actions[bot] b429124771 Ingest games [2026-10-15 00:23] 2026-10-15 00:23:32 +00:00
f2p-tracker-admin[bot] d53cfdf115 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-15 00:15:15 +00:00
github-actions[bot] 8d1190be8b Ingest games [2026-10-15 00:08] 2026-10-15 00:08:30 +00:00
f2p-tracker-admin[bot] 7124a8ebc3 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-15 00:00:15 +00:00
github-actions[bot] 2b540074b5 Snapshot [2026-10-14] 2026-10-14 23:13:59 +00:00
github-actions[bot] dd41d3fd03 Refresh all-time peaks [2026-10-14] 2026-10-14 19:44:58 +00:00
github-actions[bot] 90ea3ebe01 Ingest games [2026-10-14 17:50] 2026-10-14 17:50:49 +00:00
f2p-tracker-admin[bot] 0eaa77c739 queue: 64 auto-approved games
Approved automatically by the /admin schedule (at most 300 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-14 17:45:31 +00:00
github-actions[bot] e427e399c4 Refresh store data [2026-10-14] 2026-10-14 16:58:08 +00:00
github-actions[bot] 5b18f97cb4 Ingest games [2026-10-14 09:02] 2026-10-14 09:02:23 +00:00
f2p-tracker-admin[bot] 2c05c9bf39 queue: 7 auto-approved games
Approved automatically by the /admin schedule (at most 300 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-14 09:01:36 +00:00
github-actions[bot] a5aba7a6ba Ingest games [2026-10-14 08:54] 2026-10-14 08:54:09 +00:00
f2p-tracker-admin[bot] af0c7278b4 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 300 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-14 08:45:50 +00:00
github-actions[bot] 7fc7a35ddb Ingest games [2026-10-14 07:43] 2026-10-14 07:43:01 +00:00
f2p-tracker-admin[bot] d18bae9405 queue: 15 approved games
Approved in /admin by admin.

Reason: test

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-14 07:41:38 +00:00
github-actions[bot] c0b12362c2 Ingest games [2026-10-14 05:16] 2026-10-14 05:16:36 +00:00
f2p-tracker-admin[bot] 32eb7a0841 queue: 11 auto-approved games
Approved automatically by the /admin schedule (at most 300 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-14 05:15:31 +00:00
github-actions[bot] b6627e0c0c Top online [2026-10-14 03:50] 2026-10-14 03:50:05 +00:00
github-actions[bot] 9c1135f6f4 Ingest games [2026-10-14 01:23] 2026-10-14 01:23:36 +00:00
f2p-tracker-admin[bot] 63258ea962 queue: 97 auto-approved games
Approved automatically by the /admin schedule (at most 300 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-14 01:15:30 +00:00
github-actions[bot] 40f2b7f75b Auto update [2026-10-14] 2026-10-14 00:20:00 +00:00
github-actions[bot] 474fa9f9cb Ingest games [2026-10-14 00:02] 2026-10-14 00:02:33 +00:00
f2p-tracker-admin[bot] 67f7c541ea queue: 21 auto-approved games
Approved automatically by the /admin schedule (at most 300 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-14 00:00:46 +00:00
github-actions[bot] b28ed6ad47 Ingest games [2026-10-13 23:32] 2026-10-13 23:32:16 +00:00
f2p-tracker-admin[bot] 45021cd335 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 300 a day), enabled by admin.

Reason: run by hand from /admin/automation

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-13 23:24:02 +00:00
github-actions[bot] f947b832a7 Snapshot [2026-10-13] 2026-10-13 23:13:12 +00:00
github-actions[bot] 4a3dca16cc Refresh all-time peaks [2026-10-13] 2026-10-13 19:43:47 +00:00
github-actions[bot] a7389eadad Refresh store data [2026-10-13] 2026-10-13 17:00:25 +00:00
github-actions[bot] 1b3835c0ca Ingest games [2026-10-13 14:54] 2026-10-13 14:54:16 +00:00
f2p-tracker-admin[bot] 213d70c64d queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 300 a day), enabled by admin.

Reason: run by hand from /admin/automation

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-13 14:46:03 +00:00
github-actions[bot] c5857870cd Ingest games [2026-10-13 11:11] 2026-10-13 11:11:03 +00:00
f2p-tracker-admin[bot] f03ddcf206 queue: 100 auto-approved games
Approved automatically by the /admin schedule (at most 300 a day), enabled by admin.

Reason: run by hand from /admin/automation

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-13 11:02:54 +00:00
github-actions[bot] 98537d2d67 Update reviews [2026-10-13] 2026-10-13 10:04:05 +00:00
poli0981 6103ab32b0 Merge pull request #186 from poli0981/dependabot/npm_and_yarn/web/vite-plugin-pwa-2.0.0
chore(deps-dev): Bump vite-plugin-pwa from 1.3.0 to 2.0.0 in /web
2026-10-13 13:39:42 +07:00
poli0981 54d3f47f98 Merge branch 'main' into dependabot/npm_and_yarn/web/vite-plugin-pwa-2.0.0 2026-10-13 13:30:25 +07:00
poli0981 72b88f00de Merge pull request #185 from poli0981/dependabot/npm_and_yarn/web/npm-minor-patch-6963b76e56
chore(deps-dev): Bump @types/node from 22.19.17 to 22.20.5 in /web in the npm-minor-patch group
2026-10-13 13:29:44 +07:00
dependabot[bot] b2a4517de0 chore(deps-dev): Bump vite-plugin-pwa from 1.3.0 to 2.0.0 in /web
Bumps [vite-plugin-pwa](https://github.com/vite-pwa/vite-plugin-pwa) from 1.3.0 to 2.0.0.
- [Release notes](https://github.com/vite-pwa/vite-plugin-pwa/releases)
- [Commits](https://github.com/vite-pwa/vite-plugin-pwa/compare/v1.3.0...v2.0.0)

---
updated-dependencies:
- dependency-name: vite-plugin-pwa
  dependency-version: 2.0.0
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-13 06:20:38 +00:00
dependabot[bot] c51b4e7faf chore(deps-dev): Bump @types/node in /web in the npm-minor-patch group
Bumps the npm-minor-patch group in /web with 1 update: [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node).


Updates `@types/node` from 22.19.17 to 22.20.5
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node)

---
updated-dependencies:
- dependency-name: "@types/node"
  dependency-version: 22.20.5
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-13 06:20:09 +00:00
poli0981 7cbf5b3f9b Merge pull request #183 from poli0981/feat/admin-autopilot
feat(admin): auto-approve, remove/restore games, Overview/Pipeline/Quality pages (v4.3.0)
2026-10-13 13:18:41 +07:00
poli0981andClaude Opus 5.5 2ff7b0c260 fix(ci): mark-dead-games.yml did not parse
The commit step's plain `run:` scalar contained "chore(data): mark dead
games", and a colon followed by a space inside a plain scalar is a
mapping indicator: "mapping values are not allowed here" (line 61). GitHub
answered every push of this branch with a failed run named after the file,
and on main the scheduled job would have stopped running. A block scalar
carries the command as text.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 13:17:12 +07:00
poli0981andClaude Opus 5.5 90f6c72c98 fix(deps): rustls 0.23.45 in the app shell (GHSA-2mjx-qc3c-rqvc)
Dependabot alert #69: rustls before 0.23.45 accepted TLS 1.3 handshake
messages across encryption-level boundaries. Lockfile only - rustls
0.23.40 -> 0.23.45, rustls-webpki 0.103.13 -> 0.103.15 - and only the
desktop updater's reqwest uses it. cargo test --lib --locked passes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 13:15:17 +07:00
poli0981andClaude Opus 5.5 92cbbebac4 fix(worker): never put a thrown value's String() in a response
CodeQL (js/stack-trace-exposure) followed a caught exception through
String(err) into the /admin/api/pipeline 502 and auto-approve's "failed"
detail, which /admin/api/automation/run returns. lib/http.ts errorText()
gives an Error's message and only describes anything else that was thrown.

The admin-api test walked worker/ with statSync before readFileSync
(js/file-system-race); it reads the directory entries' types instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 13:13:51 +07:00
poli0981andClaude Opus 5.5 7fd329cc83 release: v4.3.0 - The "Autopilot" Edition
Auto-approve for the review queue (off by default, at most 500 a day),
removing games through data/blocklist.jsonl with Restore, and the
Overview, Pipeline and Data quality admin pages. Apps stay at 2.2.0; no D1
migration; the GitHub App's permissions are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 13:09:35 +07:00
poli0981andClaude Opus 5.5 997cbd9208 docs: removals, auto-approve and the new admin pages
CLAUDE.md:
- data/blocklist.jsonl as a data invariant: applied first in save_main(),
  logged once, the 500 guard, never named data_*, whole-line writers, the
  shared golden fixture, Restore as the only way back.
- The pipeline rules for ingest (blocked links skipped, non-games refused,
  ingest-new.yml as the removal job on ref main), auto-approve's gates, and
  Remove/Restore's D1 semantics and WRITABLE paths.
- "Publication stays a human decision" now says who decides: a reviewer, or
  the capped auto-approve rule a reviewer turned on.
- Admin routes: the Overview at /admin, the queue at /admin/queue, and no
  /admin/api route answering 401/403 for anything but Access.
- save_main() has 14 callers, not 11 (here and in core/overrides.py).

docs/ADMIN.md: the App's Contents permission covers temp_info, overrides
and the blocklist (never a shard); why Actions read is not needed; the
discovery token's reach with auto-approve on; sections 11-13 for
auto-approve, removing/restoring and the Overview/Pipeline/Quality pages;
the mock's mock_pipeline switch.

README.md: the admin's description, the new scripts and the ingest
workflow's triggers.

Also: the delete_game.py help example kept its line break, and the mock's
removed rows carry the reason's label as the Worker writes it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 13:08:13 +07:00
poli0981andClaude Opus 5.5 bac338caf5 feat(admin): Overview, Automation, Remove, Quality and Pipeline pages
The admin grows from five pages to ten. /admin is now the Overview - queue
counts and the backlog by source, auto-approve's day, removed games waiting
for the pipeline, running data jobs, data-quality counts - each card loaded
on its own. The review queue moves to /admin/queue; an old /admin?status=...
link is rewritten there on load (legacyQueuePath), so bookmarks keep working.

- Automation: the switch and limits (validated by the same shared rules the
  Worker uses), today's budget, the last run and why it did or did not
  approve, the next batch, history, and Run one batch now.
- Remove: search the catalogue or paste up to 100 appids/links, pick a
  reason, see that it is public, confirm; the Removed tab lists the blocklist
  with what is still waiting for the pipeline, and Restore. Edit links here.
- Quality: every check's count, grouped by who fixes it, and each check's
  games with an Edit link.
- Pipeline: the latest runs per data workflow, what is running or waiting
  in data-write, and what is queued in Git.
- The queue dialog says a removed game comes back through Restore; Reopen's
  refusal says the same. Jobs and Audit filter on the shared JOB_KINDS and
  AUDIT_ACTIONS.
- Nav labels show from xl; below that, icons with a title. Links and table
  wrappers are positioned, so an sr-only label scrolled out of view no longer
  widens the page at 375 px.
- The pipeline endpoint lists each run once: the page keys on run URLs, and
  a duplicate key throws in a keyed {#each}.
- The mock dev server serves the new pages: fake Actions runs
  (mock_pipeline=busy cookie), auto-approve state, two removed games.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 13:00:15 +07:00
poli0981andClaude Opus 5.5 8e99aa0825 feat(admin): pipeline and data-quality endpoints
- GET /admin/api/pipeline: the latest runs of every data workflow
  (shared/pipeline.ts, keyed by file), what is running or waiting in
  data-write, and how many lines wait in scripts/temp_info.jsonl and the
  blocklist. A weekly job that fell out of the last 100 runs is asked for by
  file. GitHub trouble is a 502 with a JSON body - never 401/403, which the
  admin page reads as an expired Access session.
- GET /admin/api/quality: counts of every shared/quality.ts check over the
  published catalogue, or one check's games, paged - computed once per
  dataset generation by readCatalogue().
- Response types for the new endpoints in shared/admin-api.ts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:44:07 +07:00
poli0981andClaude Opus 5.5 a4946662d0 feat(admin): auto-approve the pending queue on the cron, within limits
Off by default. When enabled in /admin (or run once by hand), the 15-minute
cron approves one batch after reconcile - through the same approveRows()
path as a reviewer, so it is still only a request: ingest_new.py checks every
game, and reconcile records the outcome.

Settings (admin_state, validated by shared/automation.ts on both sides):
batch size <= 100, daily limit <= 500 (a ceiling in code, re-applied on
every run), allowed sources ("backfill:*" is a prefix), minimum age, order.

A batch is committed only when every gate says yes, and a gate that cannot
be checked says no:
- the lease (one run at a time; no lease table, no run);
- the UTC day's budget, reserved with bumpCounter before the commit and
  returned when it fails (kept when the commit landed);
- scripts/temp_info.jsonl on main is EMPTY - the previous batch has been
  ingested - checked again inside the commit (requireEmptyQueue). Not "no
  row is approved", which a network-skipped row would hold for 12 hours;
- no data-write workflow is running or waiting: that group keeps ONE pending
  run, and the ingest a batch starts would evict a job waiting its turn
  (lib/github-runs.ts, the App token, shared/pipeline.ts held to the YAML);
- only pending, free, app_type game, health ok rows, old enough, from an
  allowed source, never decided, their game not committed or blocklisted.

The commit says it is automatic and names its limit, never a person; D1
records actor auto-approve (or the person who pressed Run). The last
outcome is kept for the page, and a failure is audited once per cause, not
every tick. The daily prune drops counters older than a month.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:42:43 +07:00
poli0981andClaude Opus 5.5 6608100fe2 feat(admin): remove games from the catalogue, and restore one
/admin/api/remove takes up to 100 published games, a reason and an optional
public note, and commits their lines to data/blocklist.jsonl - one commit,
re-merged with the file as it is on every retry. The push starts the ingest
workflow, whose first step takes them out of data/ (scripts/remove_games.py).

The review queue is made to agree with Git: each game's decision becomes
rejected 'removed:<code>' even over an approved one (unpublishing is a new
fact), and every row for it that is not already rejected is rejected. Its old
committed row therefore no longer makes publishedSql() call it published, so
a restored game whose ingest fails can be approved again instead of sitting
locked forever. Removing an already-removed game commits nothing and re-applies
the D1 side: the repair for a desynced removal.

/admin/api/restore takes one game back, in ONE commit: its blocklist line goes
and its store link is appended to scripts/temp_info.jsonl, so the next ingest
cannot find it still blocked and fetches it fresh. Only a 'removed:' decision
is deleted, and an approved row (source "restore") is left for reconcile to
promote. Reopen refuses a removed game and says to Restore it instead.

Remove and Restore share a D1 lease, so they cannot interleave for one game.
GET catalogue searches published games (or previews a list of appids) and GET
removed lists the blocklist with what is still waiting for the pipeline.

lib/commit-job.ts is the job-then-commit sequence routes/edit.ts had inline,
now shared with removals.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:37:45 +07:00
poli0981andClaude Opus 5.5 f82f0ead59 refactor(worker): shared removal rules, catalogue reader, one approve path
No behaviour change for the existing routes; this is what the removal and
auto-approve features stand on.

- shared/removal.ts: the blocklist line format (key order, compact JSON,
  U+2028/U+2029 escaped), reasons, parse/append/remove-one-line helpers.
  Held byte-equal to Python by scripts/tests/fixtures/blocklist_golden.jsonl,
  and REMOVAL_REASONS to blocklist.py's REASONS.
- shared/quality.ts: the data-quality checks, with safeClass() held equal to
  the public app's.
- lib/git-commit.ts: data/blocklist.jsonl joins WRITABLE (shards and
  index.json stay out); a blob GitHub returns truncated is never rewritten;
  appendLinks() takes {reason, auto, requireEmptyQueue} - an auto batch says
  so in its commit, and requireEmptyQueue refuses to commit while the queue
  file still holds a batch, checked at the same head the commit uses;
  readRepoFiles() reads several files fresh from main.
- lib/records.ts readCatalogue(): the published games as a projection with
  their quality issues, each shard checked against index.json's sha256 and
  re-read past the edge cache when stale; only verified reads are memoized.
- lib/approve.ts approveRows(): the approve path routes/admin.ts had inline,
  so a reviewer and the schedule go through the same job/commit/batch/audit
  order. lib/queue-sql.ts holds the SQL both need; lib/hash.ts the sha256.
- shared/admin-api.ts JOB_KINDS / AUDIT_ACTIONS, checked against worker/.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:33:54 +07:00
poli0981andClaude Opus 5.5 e0dc5c6668 feat(ingest): refuse a link whose Steam type is not "game"
Discovery only proposes appdetails type "game", but the ingest queue is also
fed by the browser extension and, once auto-approve is on, by candidates no
one looked at - a leaked discovery token could post a free DLC, demo or tool
claiming to be a game. ingest_new.py now checks the type Steam itself
returned in the health check it already makes, and logs a refusal as
status_code "not_a_game". A missing type (the store-page fallback) is not
held against the game.

Only in ingest: health_checker is shared with Purge, which would otherwise
start deleting existing records every week.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:33:53 +07:00
poli0981andClaude Opus 5.5 986077d3f1 feat(pipeline): data/blocklist.jsonl - save_main drops and logs removed games
A game the maintainer removes is now a standing instruction in Git, like an
override, instead of a one-time deletion that the browser extension or the
next ingest could undo.

- core/blocklist.py reads data/blocklist.jsonl (one line per game, written by
  /admin and by delete_game.py). save_main() applies it FIRST on every write,
  for all 14 callers, without touching the caller's list, and whatever
  apply_human_overrides says.
- A dropped game is logged once in scripts/removed_games.jsonl as
  status_code "admin_removed", built from the blocklist line alone with
  removed_at = blocked_at, so writing it again changes no byte. A later purge
  line for the same game keeps winning, as dedup_removed() decides.
- More than 500 drops in one save raises BlocklistError before anything is
  written: a damaged file fails the job instead of emptying the catalogue.
- remove_games.py applies the blocklist now and heals a missing log line.
  bash/ingest.sh runs it before ingest_new.py, and ingest-new.yml also
  triggers on blocklist pushes and checks out the tip of main. One workflow
  on purpose: data-write keeps one pending run, so a second workflow and the
  ingest would keep evicting each other.
- ingest_new.py skips blocked links before any Steam request, and a link
  that is not text ({"link": 730}) no longer crashes the run (and every
  three-hourly retry after it).
- Discovery counts blocked appids as known.
- delete_game.py is a non-interactive CLI writing the same bytes as /admin
  (golden fixture), with --list and --check; check-overrides.yml runs --check.
- mark-dead-games.yml commits through bash/commit_push.sh, like every other
  data job: it rebases and retries, and commits the log with the shards.
- dependabot.yml ignores Svelte-era framework majors and @types/node majors
  instead of the React-era names.

With an empty blocklist every path is a no-op.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:33:53 +07:00
poli0981 e70e1f770e Merge pull request #182 from poli0981/dependabot/npm_and_yarn/web/npm-minor-patch-43c8c58923
chore(deps): Bump the npm-minor-patch group across 1 directory with 11 updates
2026-10-13 12:33:47 +07:00
poli0981 ccf79e1d44 Merge pull request #181 from poli0981/dependabot/cargo/web/src-tauri/cargo-minor-patch-267a3b0d35
chore(deps): Bump the cargo-minor-patch group across 1 directory with 4 updates
2026-10-13 12:33:43 +07:00
dependabot[bot] 87b7e67bdd chore(deps): Bump the npm-minor-patch group across 1 directory with 11 updates
Bumps the npm-minor-patch group with 11 updates in the /web directory:

| Package | From | To |
| --- | --- | --- |
| [@lucide/svelte](https://github.com/lucide-icons/lucide/tree/HEAD/packages/svelte) | `1.49.0` | `1.54.0` |
| [@tanstack/svelte-virtual](https://github.com/TanStack/virtual/tree/HEAD/packages/svelte-virtual) | `3.13.39` | `3.13.40` |
| [@tauri-apps/api](https://github.com/tauri-apps/tauri) | `2.12.0` | `2.12.2` |
| [@tauri-apps/plugin-shell](https://github.com/tauri-apps/plugins-workspace) | `2.4.0` | `2.4.1` |
| [@tauri-apps/plugin-updater](https://github.com/tauri-apps/plugins-workspace) | `2.13.1` | `2.13.2` |
| [bits-ui](https://github.com/huntabyte/bits-ui) | `2.19.3` | `2.19.5` |
| [@tauri-apps/cli](https://github.com/tauri-apps/tauri) | `2.12.0` | `2.12.1` |
| [knip](https://github.com/webpro-nl/knip/tree/HEAD/packages/knip) | `6.39.0` | `6.41.0` |
| [svelte](https://github.com/sveltejs/svelte/tree/HEAD/packages/svelte) | `5.57.1` | `5.57.2` |
| [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) | `8.3.1` | `8.3.4` |
| [wrangler](https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler) | `4.147.0` | `4.149.0` |



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

Updates `@tanstack/svelte-virtual` from 3.13.39 to 3.13.40
- [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.40/packages/svelte-virtual)

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

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

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

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

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

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

Updates `svelte` from 5.57.1 to 5.57.2
- [Release notes](https://github.com/sveltejs/svelte/releases)
- [Changelog](https://github.com/sveltejs/svelte/blob/main/packages/svelte/CHANGELOG.md)
- [Commits](https://github.com/sveltejs/svelte/commits/svelte@5.57.2/packages/svelte)

Updates `vite` from 8.3.1 to 8.3.4
- [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.4/packages/vite)

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

---
updated-dependencies:
- dependency-name: "@lucide/svelte"
  dependency-version: 1.54.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.40
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/api"
  dependency-version: 2.12.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/plugin-shell"
  dependency-version: 2.4.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/plugin-updater"
  dependency-version: 2.13.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: bits-ui
  dependency-version: 2.19.5
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/cli"
  dependency-version: 2.12.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: knip
  dependency-version: 6.41.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: svelte
  dependency-version: 5.57.2
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: vite
  dependency-version: 8.3.4
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: wrangler
  dependency-version: 4.149.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-10-13 05:19:44 +00:00
dependabot[bot] 1b201edde7 chore(deps): Bump the cargo-minor-patch group across 1 directory with 4 updates
Bumps the cargo-minor-patch group with 4 updates in the /web/src-tauri directory: [tauri](https://github.com/tauri-apps/tauri), [tauri-plugin-shell](https://github.com/tauri-apps/plugins-workspace), [tauri-plugin-updater](https://github.com/tauri-apps/plugins-workspace) and [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace).


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

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

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

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

---
updated-dependencies:
- dependency-name: tauri
  dependency-version: 2.12.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-shell
  dependency-version: 2.4.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-updater
  dependency-version: 2.13.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-single-instance
  dependency-version: 2.5.2
  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-13 05:18:40 +00:00
github-actions[bot] 56341b4514 Auto update [2026-10-13] 2026-10-13 00:25:32 +00:00
github-actions[bot] 97445144e9 Snapshot [2026-10-12] 2026-10-12 23:16:20 +00:00
github-actions[bot] 585a13a24e Refresh all-time peaks [2026-10-12] 2026-10-12 19:46:24 +00:00
github-actions[bot] 1deaea9418 Refresh store data [2026-10-12] 2026-10-12 16:59:17 +00:00
github-actions[bot] 25741b53b4 Ingest games [2026-10-12 15:55] 2026-10-12 15:55:58 +00:00
f2p-tracker-admin[bot] 507614e85d 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-12 15:47:53 +00:00
github-actions[bot] c31176b09c Purge unhealthy [2026-10-12] 2026-10-12 08:46:22 +00:00
github-actions[bot] 11aadeb1d2 chore(data): mark dead games 2026-10-12 04:53:51 +00:00
github-actions[bot] 7e215fa9d5 Ingest games [2026-10-12 01:33] 2026-10-12 01:33:58 +00:00
f2p-tracker-admin[bot] 19c5b4b13a 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-12 01:25:47 +00:00
github-actions[bot] 91a78bd6d2 Auto update [2026-10-12] 2026-10-12 00:27:11 +00:00
github-actions[bot] 126fb81678 Snapshot [2026-10-11] 2026-10-11 23:16:04 +00:00
github-actions[bot] 06943d883b Refresh all-time peaks [2026-10-11] 2026-10-11 19:43:34 +00:00
github-actions[bot] ffa1efa368 Refresh store data [2026-10-11] 2026-10-11 16:56:11 +00:00
github-actions[bot] 3d44240b39 Top online [2026-10-11 03:52] 2026-10-11 03:52:59 +00:00
github-actions[bot] dc8b09290a Ingest games [2026-10-11 01:58] 2026-10-11 01:58:32 +00:00
f2p-tracker-admin[bot] 5b0904c21a queue: 100 approved games
Approved in /admin 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-11 01:50:14 +00:00
github-actions[bot] d830a858c7 Auto update [2026-10-11] 2026-10-11 00:26:21 +00:00
github-actions[bot] c0e4f7e8ed Snapshot [2026-10-10] 2026-10-10 23:15:37 +00:00
github-actions[bot] 03f0ce44b9 Refresh all-time peaks [2026-10-10] 2026-10-10 19:42:57 +00:00
github-actions[bot] b775ddd41a Refresh store data [2026-10-10] 2026-10-10 16:53:58 +00:00
github-actions[bot] f75ac428c4 Ingest games [2026-10-10 11:02] 2026-10-10 11:02:48 +00:00
f2p-tracker-admin[bot] 68b76dccd7 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-10 10:54:44 +00:00
github-actions[bot] 68d0a31665 Refresh store data [2026-10-10] 2026-10-10 04:33:51 +00:00
poli0981 a2c53973f3 Merge pull request #179 from poli0981/fix/adult-only-store-fields-and-dates
fix(pipeline): read age-gated games from Steam's JSON API; one release-date shape (v4.2.1)
2026-10-10 10:50:56 +07:00
poli0981andClaude Opus 5.5 62d437fb8d release: v4.2.1 - The "Age Gate" Edition (apps unchanged, 2.2.0)
Pipeline only: nothing under web/ changed, so there is no new web, desktop
or Android build and no app version bump. The catalogue picks the fixes up
from the next data job.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 10:48:50 +07:00
poli0981andClaude Opus 5.5 8bbdcb334c fix(pipeline): read age-gated games from Steam's JSON API; one release-date shape
An 'Adult Only' game's store page sends an anonymous client to /agecheck/
and on to a Sign In page that no age cookie opens (measured 2026-10-10).
The scraper read that page as the game's own: no language table, no tags,
no DLC section. 25 games sat with empty tags and languages (about 16 adult
games, plus Warframe, PUBG, Rainbow Six Siege and other M-rated games that
were gated on the US runners), and every one was written has_paid_dlc=false.

- steam_client: classify where a store-page request ENDED (the whole
  redirect chain), send age cookies with store-page requests only, ask
  appdetails and the page for l=english, add GetItems and GetTagList
  (keyless).
- store_items: a pure parser for GetItems items in scrape_store_page()'s
  shape (ELanguage tables derived from Steam's own data), plus DLC prices.
- fetcher.scrape_store_fields(): the page first, the JSON API when the page
  is gated or redirected, has_paid_dlc from the DLC's prices; None never
  overwrites a stored flag.
- refresh_store_data: a game with empty store fields is refreshed every
  day, first, capped at 150; --missing-only; values compared as stored.
- scraper: unescape tag and language names ("Point &amp; Click"), name the
  "#lang_slovakian" token.
- normalize, run by save_main() before overrides (idempotent, never bumps
  last_updated): release_date as "Aug 21, 2012" from any shape Steam
  writes; invisible characters and stray whitespace out of names and
  blurbs; HTML entities decoded in tags and descriptions; the extension's
  "Có DLC trả phí" notes as "Has paid DLC" (overrides translated too, so
  they cannot flip-flop).

Dry run on the 25 against Steam: 24 filled, 7 has_paid_dlc corrected
(396420 has no languages on Steam itself). The dataset normalised in
memory: 1,360 dates, 482 notes, 781 entity and 56 text records change, a
second pass changes nothing, and no last_updated moves.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 10:48:31 +07:00
github-actions[bot] 3315a36ab0 Auto update [2026-10-10] 2026-10-10 00:23:54 +00:00
github-actions[bot] 7ac2c9c481 Snapshot [2026-10-09] 2026-10-09 23:15:45 +00:00
github-actions[bot] 3b2e86b814 Refresh all-time peaks [2026-10-09] 2026-10-09 19:45:33 +00:00
github-actions[bot] 913b3c1ffa Refresh store data [2026-10-09] 2026-10-09 16:55:59 +00:00
github-actions[bot] c1b476461a Ingest games [2026-10-09 15:36] 2026-10-09 15:36:46 +00:00
f2p-tracker-admin[bot] 58194fe650 queue: 25 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-09 15:34:33 +00:00
github-actions[bot] cca04c7b8b Update reviews [2026-10-09] 2026-10-09 09:47:32 +00:00
github-actions[bot] 44866b4136 Top online [2026-10-09 03:51] 2026-10-09 03:51:10 +00:00
github-actions[bot] 34906159cd Auto update [2026-10-09] 2026-10-09 00:24:31 +00:00
github-actions[bot] f9346e3cfd Snapshot [2026-10-08] 2026-10-08 23:15:55 +00:00
github-actions[bot] 75c14bcc96 Refresh all-time peaks [2026-10-08] 2026-10-08 19:46:36 +00:00
github-actions[bot] 10bb5daed7 Refresh store data [2026-10-08] 2026-10-08 16:58:18 +00:00
github-actions[bot] b7c99a1eff Ingest games [2026-10-08 08:14] 2026-10-08 08:14:22 +00:00
f2p-tracker-admin[bot] 25b11e54da 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-08 08:06:14 +00:00
github-actions[bot] 46b9d46775 Ingest games [2026-10-08 07:55] 2026-10-08 07:55:38 +00:00
f2p-tracker-admin[bot] acd5e1c168 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-08 07:47:32 +00:00
github-actions[bot] 68d8313fdc Ingest games [2026-10-08 07:32] 2026-10-08 07:32:07 +00:00
f2p-tracker-admin[bot] adf0f8865f 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-10-08 07:23:57 +00:00
github-actions[bot] 3ecc812d57 chore(data): mark dead games 2026-10-08 04:44:03 +00:00
github-actions[bot] cf6bba51ca Auto update [2026-10-08] 2026-10-08 00:22:54 +00:00
github-actions[bot] 84755ead4b Snapshot [2026-10-07] 2026-10-07 23:14:58 +00:00
github-actions[bot] 28ff21c59c Refresh all-time peaks [2026-10-07] 2026-10-07 19:45:10 +00:00
github-actions[bot] a4785131fd Ingest games [2026-10-07 12:36] 2026-10-07 12:36:47 +00:00
github-actions[bot] b854789c11 Update reviews [2026-10-07] 2026-10-07 09:34:56 +00:00
f2p-tracker-admin[bot] 4fcc4ae441 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-10-07 08:40:02 +00:00
github-actions[bot] b1867b0abb Top online [2026-10-07 03:48] 2026-10-07 03:48:47 +00:00
github-actions[bot] 68e8675632 Auto update [2026-10-07] 2026-10-07 00:24:01 +00:00
github-actions[bot] a932187f7e Snapshot [2026-10-06] 2026-10-06 23:16:13 +00:00
github-actions[bot] 52410baed3 Refresh all-time peaks [2026-10-06] 2026-10-06 19:47:15 +00:00
github-actions[bot] 06d7fb88c5 Refresh store data [2026-10-06] 2026-10-06 16:55:25 +00:00
github-actions[bot] d4d4951c0c Ingest games [2026-10-06 01:53] 2026-10-06 01:53:12 +00:00
f2p-tracker-admin[bot] ec52c3ec8f 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-10-06 01:44:59 +00:00
github-actions[bot] 74dba73bf2 Auto update [2026-10-06] 2026-10-06 00:23:17 +00:00
github-actions[bot] f27864d1ce Snapshot [2026-10-05] 2026-10-05 23:15:53 +00:00
github-actions[bot] 6c8ebe535a Refresh all-time peaks [2026-10-05] 2026-10-05 19:47:30 +00:00
github-actions[bot] 0bbdf8b4cc Refresh store data [2026-10-05] 2026-10-05 16:53:53 +00:00
github-actions[bot] a597cff5b2 Ingest games [2026-10-05 12:32] 2026-10-05 12:32:25 +00:00
f2p-tracker-admin[bot] 0b06227ea4 queue: 50 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-10-05 12:28:14 +00:00
poli0981 ee0c34776e Merge pull request #134 from poli0981/dependabot/github_actions/actions-all-ec267f2cc7
chore(deps): Bump the actions-all group across 1 directory with 7 updates
2026-10-05 15:52:06 +07:00
poli0981 667ced34ea Merge branch 'main' into dependabot/github_actions/actions-all-ec267f2cc7 2026-10-05 15:50:11 +07:00
github-actions[bot] da5934c1f1 Purge unhealthy [2026-10-05] 2026-10-05 08:31:10 +00:00
poli0981 b01341c3a2 Merge branch 'main' into dependabot/github_actions/actions-all-ec267f2cc7 2026-10-05 14:58:03 +07:00
poli0981 df75fc83c9 Merge pull request #155 from poli0981/dependabot/cargo/web/src-tauri/cargo-minor-patch-50514df42a
chore(deps): Bump the cargo-minor-patch group across 1 directory with 7 updates
2026-10-05 14:57:40 +07:00
poli0981 131de32818 Merge branch 'main' into dependabot/cargo/web/src-tauri/cargo-minor-patch-50514df42a 2026-10-05 14:57:26 +07:00
github-actions[bot] e88b2f4c3e chore(data): mark dead games 2026-10-05 05:04:38 +00:00
github-actions[bot] 3d427772c9 Auto update [2026-10-05] 2026-10-05 00:25:04 +00:00
github-actions[bot] b0e9a65831 Snapshot [2026-10-04] 2026-10-04 23:15:08 +00:00
github-actions[bot] dc2df2101a Refresh all-time peaks [2026-10-04] 2026-10-04 20:32:34 +00:00
github-actions[bot] 38f8638fcd Refresh store data [2026-10-04] 2026-10-04 18:03:13 +00:00
github-actions[bot] 6a496bd190 Top online [2026-10-04 04:44] 2026-10-04 04:44:28 +00:00
poli0981 6280473fa2 Merge pull request #171 from poli0981/dependabot/npm_and_yarn/web/npm-minor-patch-a311536240
chore(deps): Bump the npm-minor-patch group across 1 directory with 17 updates
2026-10-04 09:55:31 +07:00
poli0981 bdbad6adc0 Merge branch 'main' into dependabot/npm_and_yarn/web/npm-minor-patch-a311536240 2026-10-04 09:54:57 +07:00
github-actions[bot] 91f1b21569 Auto update [2026-10-04] 2026-10-04 01:03:26 +00:00
github-actions[bot] 79b177e512 Snapshot [2026-10-03] 2026-10-03 23:52:58 +00:00
github-actions[bot] fc44a1691e Refresh all-time peaks [2026-10-03] 2026-10-03 20:21:00 +00:00
github-actions[bot] df1fd26378 Refresh store data [2026-10-03] 2026-10-03 17:55:03 +00:00
github-actions[bot] 3ff82bbcae Ingest games [2026-10-03 14:13] 2026-10-03 14:13:44 +00:00
f2p-tracker-admin[bot] cd1cfa0721 queue: 50 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-10-03 14:09:33 +00:00
dependabot[bot] 09190b2927 chore(deps): Bump the npm-minor-patch group across 1 directory with 17 updates
Bumps the npm-minor-patch group with 17 updates in the /web directory:

| Package | From | To |
| --- | --- | --- |
| [@lucide/svelte](https://github.com/lucide-icons/lucide/tree/HEAD/packages/svelte) | `1.45.0` | `1.49.0` |
| [@tanstack/svelte-virtual](https://github.com/TanStack/virtual/tree/HEAD/packages/svelte-virtual) | `3.13.38` | `3.13.39` |
| [@tauri-apps/api](https://github.com/tauri-apps/tauri) | `2.11.0` | `2.12.0` |
| [@tauri-apps/plugin-process](https://github.com/tauri-apps/plugins-workspace) | `2.3.1` | `2.4.0` |
| [@tauri-apps/plugin-shell](https://github.com/tauri-apps/plugins-workspace) | `2.3.5` | `2.4.0` |
| [@tauri-apps/plugin-updater](https://github.com/tauri-apps/plugins-workspace) | `2.10.1` | `2.13.1` |
| [bits-ui](https://github.com/huntabyte/bits-ui) | `2.19.2` | `2.19.3` |
| [fuse.js](https://github.com/krisk/Fuse) | `7.3.0` | `7.5.0` |
| [idb-keyval](https://github.com/jakearchibald/idb-keyval) | `6.2.2` | `6.3.0` |
| [tailwind-merge](https://github.com/dcastil/tailwind-merge/tree/HEAD/packages/tailwind-merge) | `3.6.0` | `3.7.0` |
| [@sveltejs/vite-plugin-svelte](https://github.com/sveltejs/vite-plugin-svelte/tree/HEAD/packages/vite-plugin-svelte) | `7.3.0` | `7.3.1` |
| [@tauri-apps/cli](https://github.com/tauri-apps/tauri) | `2.11.1` | `2.12.0` |
| [knip](https://github.com/webpro-nl/knip/tree/HEAD/packages/knip) | `6.14.2` | `6.39.0` |
| [rollup-plugin-visualizer](https://github.com/btd/rollup-plugin-visualizer) | `7.0.1` | `7.1.1` |
| [svelte](https://github.com/sveltejs/svelte/tree/HEAD/packages/svelte) | `5.57.0` | `5.57.1` |
| [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) | `8.0.16` | `8.3.1` |
| [vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest) | `5.0.0` | `5.0.3` |



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

Updates `@tanstack/svelte-virtual` from 3.13.38 to 3.13.39
- [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.39/packages/svelte-virtual)

Updates `@tauri-apps/api` from 2.11.0 to 2.12.0
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/@tauri-apps/api-v2.11.0...@tauri-apps/api-v2.12.0)

Updates `@tauri-apps/plugin-process` from 2.3.1 to 2.4.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/os-v2.3.1...os-v2.4.0)

Updates `@tauri-apps/plugin-shell` from 2.3.5 to 2.4.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/nfc-v2.3.5...os-v2.4.0)

Updates `@tauri-apps/plugin-updater` from 2.10.1 to 2.13.1
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/updater-v2.10.1...updater-v2.13.1)

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

Updates `fuse.js` from 7.3.0 to 7.5.0
- [Release notes](https://github.com/krisk/Fuse/releases)
- [Changelog](https://github.com/krisk/Fuse/blob/main/CHANGELOG.md)
- [Commits](https://github.com/krisk/Fuse/compare/v7.3.0...v7.5.0)

Updates `idb-keyval` from 6.2.2 to 6.3.0
- [Changelog](https://github.com/jakearchibald/idb-keyval/blob/main/CHANGELOG.md)
- [Commits](https://github.com/jakearchibald/idb-keyval/compare/v6.2.2...v6.3.0)

Updates `tailwind-merge` from 3.6.0 to 3.7.0
- [Release notes](https://github.com/dcastil/tailwind-merge/releases)
- [Commits](https://github.com/dcastil/tailwind-merge/commits/tailwind-merge@3.7.0/packages/tailwind-merge)

Updates `@sveltejs/vite-plugin-svelte` from 7.3.0 to 7.3.1
- [Release notes](https://github.com/sveltejs/vite-plugin-svelte/releases)
- [Changelog](https://github.com/sveltejs/vite-plugin-svelte/blob/main/packages/vite-plugin-svelte/CHANGELOG.md)
- [Commits](https://github.com/sveltejs/vite-plugin-svelte/commits/@sveltejs/vite-plugin-svelte@7.3.1/packages/vite-plugin-svelte)

Updates `@tauri-apps/cli` from 2.11.1 to 2.12.0
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/@tauri-apps/cli-v2.11.1...@tauri-apps/cli-v2.12.0)

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

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

Updates `svelte` from 5.57.0 to 5.57.1
- [Release notes](https://github.com/sveltejs/svelte/releases)
- [Changelog](https://github.com/sveltejs/svelte/blob/main/packages/svelte/CHANGELOG.md)
- [Commits](https://github.com/sveltejs/svelte/commits/svelte@5.57.1/packages/svelte)

Updates `vite` from 8.0.16 to 8.3.1
- [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.1/packages/vite)

Updates `vitest` from 5.0.0 to 5.0.3
- [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.3/packages/vitest)

---
updated-dependencies:
- dependency-name: "@lucide/svelte"
  dependency-version: 1.49.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: "@sveltejs/vite-plugin-svelte"
  dependency-version: 7.3.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tanstack/svelte-virtual"
  dependency-version: 3.13.39
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/api"
  dependency-version: 2.12.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.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/plugin-process"
  dependency-version: 2.4.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: "@tauri-apps/plugin-shell"
  dependency-version: 2.4.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.13.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: bits-ui
  dependency-version: 2.19.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: fuse.js
  dependency-version: 7.5.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: idb-keyval
  dependency-version: 6.3.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: knip
  dependency-version: 6.39.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.1
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: svelte
  dependency-version: 5.57.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-minor-patch
- dependency-name: tailwind-merge
  dependency-version: 3.7.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: vite
  dependency-version: 8.3.1
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: npm-minor-patch
- dependency-name: vitest
  dependency-version: 5.0.3
  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-03 13:40:19 +00:00
dependabot[bot] 127079d9c4 chore(deps): Bump the cargo-minor-patch group across 1 directory with 7 updates
Bumps the cargo-minor-patch group with 7 updates in the /web/src-tauri directory:

| Package | From | To |
| --- | --- | --- |
| [serde_json](https://github.com/serde-rs/json) | `1.0.149` | `1.0.151` |
| [serde](https://github.com/serde-rs/serde) | `1.0.228` | `1.0.229` |
| [tauri-plugin-shell](https://github.com/tauri-apps/plugins-workspace) | `2.3.5` | `2.4.0` |
| [tauri-plugin-updater](https://github.com/tauri-apps/plugins-workspace) | `2.10.1` | `2.13.1` |
| [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace) | `2.4.2` | `2.5.1` |
| [tauri-plugin-process](https://github.com/tauri-apps/plugins-workspace) | `2.3.1` | `2.4.0` |
| [tauri-build](https://github.com/tauri-apps/tauri) | `2.6.1` | `2.7.1` |



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

Updates `serde` from 1.0.228 to 1.0.229
- [Release notes](https://github.com/serde-rs/serde/releases)
- [Commits](https://github.com/serde-rs/serde/compare/v1.0.228...v1.0.229)

Updates `tauri-plugin-shell` from 2.3.5 to 2.4.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/nfc-v2.3.5...os-v2.4.0)

Updates `tauri-plugin-updater` from 2.10.1 to 2.13.1
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/updater-v2.10.1...updater-v2.13.1)

Updates `tauri-plugin-single-instance` from 2.4.2 to 2.5.1
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.4.2...fs-v2.5.1)

Updates `tauri-plugin-process` from 2.3.1 to 2.4.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/os-v2.3.1...os-v2.4.0)

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

---
updated-dependencies:
- dependency-name: serde
  dependency-version: 1.0.229
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
- dependency-name: serde_json
  dependency-version: 1.0.151
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: cargo-minor-patch
- dependency-name: tauri-build
  dependency-version: 2.7.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-process
  dependency-version: 2.4.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-shell
  dependency-version: 2.4.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.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: cargo-minor-patch
- dependency-name: tauri-plugin-updater
  dependency-version: 2.13.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: cargo-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-03 13:38:38 +00:00
poli0981 f4fdd51525 Merge pull request #170 from poli0981/release/v4.2.0
release: v4.2.0 - The "All-Time High" Edition (app 2.2.0)
2026-10-03 20:35:37 +07:00
poli0981andClaude Opus 5.5 3eb960bf24 release: v4.2.0 - The "All-Time High" Edition (app 2.2.0)
Web app and desktop/Android 2.1.1 -> 2.2.0 (package.json + lock, Cargo.toml
+ the f2p-tracker entry in Cargo.lock, tauri.conf.json, from which the
Android versionCode derives); repo public-facing version 4.1.1 -> 4.2.0.
CHANGELOG's Unreleased section is dated and named, and a fresh empty one
opened above it.

What 2.2.0 brings to the apps: the all-time peak row and column (#167),
the offline catalogue kept as opaque packs (#169), and the dependency
security updates (#168). The Disclaimer's new player-source paragraph
makes the apps show the consent gate once.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 20:34:30 +07:00
poli0981 a43112b277 Merge pull request #169 from poli0981/feat/opaque-catalogue-cache
feat(web): keep the offline catalogue as the packs it arrived in
2026-10-03 20:32:40 +07:00
poli0981 0cdbda1343 Merge pull request #168 from poli0981/fix/security-deps
fix(deps): close every open security alert
2026-10-03 20:31:01 +07:00
poli0981andClaude Opus 5.5 ebdd7073a1 feat(web): keep the offline catalogue as the packs it arrived in
IndexedDB held the catalogue as ~5,568 parsed records (~9.5 MB of
structured-clone objects, readable in DevTools) while fetcher.ts threw
away the pack it had just downloaded. Now the cache stores those packs:
seven Uint8Arrays, ~1.4 MB, opaque. Obfuscation and compression like
the wire packs - the key is public - never protection.

- cache.ts: new database `f2p-catalogue`, the SAME two keys the Privacy
  Policy lists (so no policy edit, no consent gate): `f2p:index` (the
  DataIndex, readable public metadata) and `f2p:records` (one pack per
  index entry). A generation is stored only when every shard arrived
  packed - the browser never packs - and every pack's IV must be its
  entry's sha256 prefix, or the cache is a miss. Both keys go in one
  setMany, records first; the old code's two set() calls could leave a
  new index next to old records.
- The copy app <= 2.1.x left in idb-keyval's default `keyval-store` is
  read like any verified generation until the next one is written,
  which delMany's it. A new database is what keeps a tab still running
  old code from reading Uint8Arrays as records; indexedDB.databases() is
  checked first so nobody gets an empty legacy database.
- games-loader.ts: readCache() hands back the index at once and the
  records lazily, so an older cached generation is never decoded just
  to compare it; fetchShard returns { plain, pack } and writeCache gets
  the packs. The verify-then-cache contract is unchanged.
- The parser worker opens packs (decodeShard), so a cache hit costs the
  main thread ~6 ms at most instead of a ~20 ms block (desktop,
  measured), for ~45 ms more until the data is ready.
- Found in the browser: Chromium's failed AES-GCM decrypt is a
  DOMException with an EMPTY message, and worker-pool's `if (error)`
  read "" as success - a damaged pack resolved as a shard with no
  records. The worker now always names the error and the pool rejects
  on any string; both have tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 20:26:36 +07:00
poli0981andClaude Opus 5.5 d4e56eba3f fix(deps): close every open security alert
19 Dependabot alerts (6 high) plus what npm audit adds; npm audit and
pip-audit now report none.

- devalue 5.9.2 -> 5.9.4, brace-expansion 2.1.4 -> 2.1.7 and
  5.0.9 -> 5.0.12, fast-uri 3.1.7 -> 3.1.8, serialize-javascript
  7.1.1 -> 7.1.2: lockfile only, every parent's range already allowed
  the fix. devalue's parser ships in the page and the apps; the rest is
  build tooling.
- wrangler 4.130.0 -> 4.147.0: miniflare pins undici exactly, and only
  wrangler >= 4.144 brings 7.29.1. Dev and deploy tooling only.
- cookie 0.6.0 -> 0.7.2 under @sveltejs/kit via an override. Kit 2.70.3
  is the newest 2.x and still asks for ^0.6.0; it imports only
  parse/serialize, which 0.7 keeps, and under adapter-static that code
  runs only at prerender and in vite dev. npm refuses a range key for a
  direct dependency (EOVERRIDE), hence the exact version; CLAUDE.md says
  what to do when kit moves. This also ends the Dependabot security
  job that failed on every push to main.
- The sharp 0.35.4 override is dropped: miniflare now pins 0.35.4
  itself, and an exact override would force a downgrade the day it
  pins a newer one.
- urllib3 2.7.0 -> 2.8.0 for the data pipeline (requests 2.34.2 allows
  it).

Verified: npm ci, typecheck, 448 tests, web build + verify-dist, Tauri
flavour build + verify-dist, wrangler deploy --dry-run, vite dev with a
Cookie header, 55 Python tests on urllib3 2.8.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 20:09:32 +07:00
github-actions[bot] e0a118ebfa Update reviews [2026-10-03] 2026-10-03 09:29:13 +00:00
github-actions[bot] 11d7aaa615 Refresh all-time peaks [2026-10-03] 2026-10-03 04:10:54 +00:00
poli0981 858b8c8203 Merge pull request #167 from poli0981/feat/all-time-peak
feat: all-time peak players (SteamCharts + our own samples), daily refresh
2026-10-03 07:18:14 +07:00
poli0981andClaude Opus 5.5 e5365b3b6e feat(web): show the all-time peak; drop the misleading "(peak N)"
- A game's page gets an "All-time peak" row, and the games table a sortable
  column ("N/A" sorts to one end, as unrated reviews do); the CSV export
  carries the field. The record type mirrors the pipeline's new field.
- The "(peak N)" beside a game's player count is gone. It showed peak_today,
  which is the highest of our own occasional samples since the last refetch -
  neither a daily peak nor an all-time one - and read like both. Its i18n key
  goes with it.
- The Disclaimer's section on player counts names Steam Charts as the source
  and says what the number is not: Steam Charts samples periodically, and
  for games it does not track the figure is only what this project has seen.
  A consent document, so returning visitors see the gate once, showing that
  paragraph. The Acknowledgements credit Steam Charts (not a consent
  document).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 07:15:48 +07:00
poli0981andClaude Opus 5.5 f997d79054 feat(data): all_time_peak, from SteamCharts and our own samples
The dataset only knew how many people play a game now. The only peak it had,
peak_today, is not today's: nothing resets it, so it is the highest of our
sparse samples (online games 3x a week, the rest twice a month) since the
last refetch - The First Descendant reads 8,052 against a real all-time peak
of 264,860.

all_time_peak is the most players a game has had at once, and it only ever
goes up (core/peaks.py):
- refresh_peaks.py reads SteamCharts' recorded all-time peak, the only public
  source older than our sampling (SteamDB forbids scraping; Valve's APIs only
  know today). It takes a crc32 thirtieth of the catalogue a day, so each game
  is asked once a month, ~186 pages 2-3 s apart. SteamCharts has no API, no
  terms and no robots.txt, so it is read politely (core/steamcharts.py): a
  User-Agent that names the project, 500/404 read as "not tracked", and a
  403, 429 or Cloudflare challenge stops the run with a warning, keeping
  everything raised so far. Measured: 9 of 10 games with a few dozen players
  or more are tracked; most of the 0-3 player long tail is not.
- Every run also raises the field from our own samples (peak_today,
  current_players) without a request, and apply_players() raises it on every
  sample - never from a 0. That seeds 2,329 games on the first run.
- Nothing else is written, last_updated included (player counts never moved
  it), and refetch_all.py does not clear the field: it cannot be fetched again.

"Refresh All-Time Peaks" runs daily at 19:30 UTC, between Refresh Store Data
and the snapshot, in the data-write group, committing through
commit_push.sh; a manual run with "backfill" asks about every game (~4 h).
The crc32 rotation moves to core/rotation.py, shared with
refresh_store_data.py. test_refresh_peaks.py holds the rules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 07:15:39 +07:00
poli0981 7e529ef81e Merge pull request #163 from poli0981/fix/mobile-layout
v4.1.1 "Pocket-Sized": fit a phone - grids, Android status bar, charts (app 2.1.1)
2026-10-03 06:46:27 +07:00
poli0981andClaude Opus 5.5 fae8d0c430 release: v4.1.1 - The "Pocket-Sized" Edition (app 2.1.1)
Web app and desktop/Android 2.1.0 -> 2.1.1 (package.json + lock, Cargo.toml
+ the f2p-tracker entry in Cargo.lock, tauri.conf.json, from which the
Android versionCode derives); repo public-facing version 4.1.0 -> 4.1.1.
CHANGELOG's Unreleased section is dated and named, and a fresh empty one
opened above it.

What 2.1.1 brings to the apps: the phone-width layout fixes, the Android
status- and navigation-bar insets, and the Privacy Policy's image-host line
(so the apps show the consent gate once).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 06:43:19 +07:00
poli0981andClaude Opus 5.5 c8a561b00e fix(charts): legends, labels and the tag cloud at phone width
- The Anti-Cheat, Delisted timeline and Catalogue growth legends wrapped to a
  second line on a phone and landed on the axis labels or the plot. They are
  scroll legends now: one line, paged when it does not fit, unchanged on a
  desktop where it does.
- Value-axis labels printed over each other where the plot is narrow (Top
  Online/Offline leave it about 80px beside the game names). hideOverlap on
  the horizontal value axes of those, Anti-Cheat, DRM and the dashboard
  genres drops the ones that collide.
- The tag cloud skipped any word too big for its box, and words are placed
  largest first, so on a phone the most common tags were the ones missing.
  shrinkToFit sizes them down instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 06:42:08 +07:00
poli0981andClaude Opus 5.5 a22589a334 fix(android): keep the app clear of the status and navigation bars
targetSdk 36 and MainActivity's enableEdgeToEdge() draw the webview under
both system bars. The React 1.x shell padded all four safe-area insets; the
SvelteKit rewrite kept only <main>'s bottom one, so the top bar of every 2.x
app has sat under the clock, which docs/android-support.md says cannot happen.

- styles/theme.css gains pt-safe, pb-safe, pl-safe, pr-safe and p-safe-or-4
  (env(safe-area-inset-*), named after the tailwindcss-safe-area classes).
  The shell root carries pt-safe pl-safe pr-safe, <main> pb-safe, the drawer
  pt-safe pb-safe pl-safe, and /welcome and the /error pages, which have no
  shell, pad themselves.
- The consent gate and the human check use p-safe-or-4 and centre their card
  with m-auto instead of items-center: on a short phone a card taller than
  the screen lost its top, unreachable (measured at 360x520: the 620px
  consent card now scrolls from its top edge).
- Back-to-top and the toasts add the bottom inset; the never-expiring Android
  update toast sat on the gesture bar.
- The status-bar icons follow the SYSTEM theme (enableEdgeToEdge() uses
  SystemBarStyle.auto), but the app defaults to dark, so a phone in light
  mode showed dark icons on a dark page. In the Android app the layout now
  puts a status-bar-strip behind them, keyed on prefers-color-scheme and
  never on the reader's theme. Its two colours are theme.css's --background
  tokens; mobile-layout.test.ts compares them and holds the shell padding.

env() reports these insets only from Android System WebView 136; an older
WebView reads 0 and keeps today's look. The Android docs now say so, and the
themes.xml comments, which still pointed at the React Layout and claimed
light icons, describe what enableEdgeToEdge() actually does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 06:42:01 +07:00
poli0981andClaude Opus 5.5 21d06a32fb fix(web): phone-width layout - grids, rows, long names
On a 360px phone (the Android app and mobile browsers) cards ran off the
right edge of Dashboard, Publishers and Developers, and game names vanished
from the Top Online/Offline and studio lists.

- 22 layout grids declared columns only from sm/lg up. Below that a grid has
  one implicit auto track sized to its widest item's min-content, and a
  truncate name counts at full length there, because the grid item keeps
  min-width:auto. Measured at 360px: the dashboard scrolled sideways by
  124px, Publishers by 46px with all 300 counts off screen. Every one now
  starts at grid-cols-1, which is repeat(1, minmax(0, 1fr)).
- Top Online/Offline and the studio pages hide the genre badge below sm, and
  the studio pages the score as Top Online already did: a Badge cannot
  shrink below its longest word, and names were squeezed to 0-28px.
- Page titles and a game's name, description and notes wrap long words: some
  studio names are raw URLs.
- The header search reserved pr-16 for the Ctrl K chip, which is hidden on
  phones, and cut the placeholder to "Search by na".
- /games cards are fixed 96px rows; a long anti-cheat badge wrapped to a
  third line and painted over the next card. The card now clips and the
  badge truncates.

src/lib/mobile-layout.test.ts fails on a layout grid without a base
grid-cols-N; CLAUDE.md has the rule.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 06:41:46 +07:00
github-actions[bot] 5da58ea47f Snapshot [2026-10-02] 2026-10-02 23:14:26 +00:00
poli0981 065e407e10 Merge pull request #162 from poli0981/perf/img-media-domain
perf(img): serve the minted AVIF from the R2 custom domain, out of Cloudflare's cache
2026-10-03 00:30:25 +07:00
poli0981 22fecf354b Merge pull request #161 from poli0981/docs/watch-paths-and-cache
docs: which commits deploy, the legal-document trap, and the cache rules
2026-10-03 00:30:14 +07:00
poli0981 2775829112 Merge pull request #160 from poli0981/perf/static-cache-headers
perf(web): cache hashed workbox, art, manifest and crawler files
2026-10-03 00:29:53 +07:00
poli0981andClaude Opus 5.5 6123f7e0cc docs: the media host in the changelog and the deploy checks
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 00:21:04 +07:00
poli0981andClaude Opus 5.5 14d052a943 docs(privacy): artwork also loads from the site's own image host
"Everything the site loads is fetched same-origin" stops being literally true
once the web app loads art from media.free-steam-games.win. The substance does
not change - it is the site's own subdomain, served by Cloudflare like the rest,
and Valve still never sees a visitor's IP - but the policy says precisely what
the browser contacts, so it says this too.

Returning visitors see the consent gate once, showing this one paragraph.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 00:20:29 +07:00
poli0981andClaude Opus 5.5 e3bf4e6a8d perf(img): serve the minted AVIF from the R2 custom domain, out of Cloudflare's cache
A Worker always runs BEFORE Cloudflare's cache, so no `s-maxage` on /img/*
could ever spare an invocation: every thumbnail and hero view ran the Worker,
and every view the edge cache had not seen read R2. An R2 custom domain is
cached like any origin. On the web, thumbnails and the detail hero now load
from https://media.free-steam-games.win/img/v2/<w>q<q>/<path>@<t>.avif - the
exact key the cron mints - and a repeat view costs neither a Worker run nor an
R2 read.

- shared/img-keys.ts is now the one definition of the key scheme, shared by
  the cron, the /img route and the page (it moved out of worker/lib/img-store.ts).
- Every such <img> carries {@attach imgFallback(...)} with the /img URL. A key
  that is not minted yet is a 404 on the media host and a browser without AVIF
  cannot decode it; both fire `error`, and /img serves Steam's JPEG. A load
  that failed before hydration is recognised by complete && naturalWidth === 0.
  images.test.ts fails on an image without the fallback, or one built from a
  different value.
- An attachment, not an action: on a prerendered <img>, `use:` makes Svelte
  write onload/onerror="this.__e=event", which the hash CSP refuses - one CSP
  violation per game page. verify-dist.mjs now fails on it anywhere.
- The web CSP lists the media host in img-src; the Tauri one does not, and the
  packaged apps keep using /img/* for everything. verify-dist checks both ways.
- The service worker's /img/ rule matched the media host too (same path
  prefix). Its responses are opaque no-cors loads the rule can never cache, so
  it is same-origin only now; the objects' year of immutable Cache-Control is
  what keeps them.
- /img remembers an R2 miss per data centre for one cron tick (15 min), so the
  fallbacks and the apps stop paying an R2 read for art the backfill has not
  reached.

Measured with the domain not yet connected (so every media load fails): the
hero and all 100 thumbnails on /top-online fell back to /img and rendered,
including lazy images below the fold; none broke.

Merge only once media.free-steam-games.win serves a minted AVIF -
docs/SECURITY_SETUP.md section 5 has the setup and the check.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 00:20:28 +07:00
poli0981andClaude Opus 5.5 75b4e08c37 docs: data commits still deploy - say so, and how to tell
The previous commit said documentation AND data commits no longer deploy.
Documentation commits do not; data commits still did: 3f9e8cff ("Refresh store
data [2026-10-02]", four files under data/) carries a Workers Builds check
with a new Version ID, 712b4ab8, at 16:54Z. DEPLOYMENT.md and CLAUDE.md now
state the rule rather than claim it is in force, keep the configuration that
stops both, and say how to verify it: the next bot data commit must have no
Workers Builds check.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 00:19:59 +07:00
github-actions[bot] 3f9e8cff76 Refresh store data [2026-10-02] 2026-10-02 16:52:56 +00:00
poli0981andClaude Opus 5.5 6198ae7cdf docs: which commits deploy, the legal-document trap, and the cache rules
- DEPLOYMENT: documentation and data commits no longer deploy (watch paths,
  2026-10-02) - except that the legal documents are build inputs
  (build/legal-versions.ts, lib/server/markdown.ts), so a commit that
  changes only them must still trigger a build, or the consent gate keeps
  the old text and hash. Gives a watch-path configuration that does both
  (excludes are applied before includes) and how to check it.
- CLAUDE.md: the same, plus how static/_headers caches by path and why
  pages, sw.js and version.json must keep revalidating.
- CHANGELOG [Unreleased]: the static cache rules (PR #160) and the above.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 23:32:57 +07:00
poli0981andClaude Opus 5.5 27db33a0c5 perf(web): cache hashed workbox, art, manifest and crawler files
Measured on production: only /_app/immutable/* had a lifetime; everything
else in static/ went out as max-age=0, must-revalidate, so every page load
re-asked for the icons, favicon, og.png and manifest, and for
workbox-<hash>.js, whose name already changes with its content.

- /workbox-*: a year, immutable (hashed like /_app/immutable/*).
- icons, favicon, apple-touch-icon, og.png, manifest.webmanifest: fresh for
  a day, then served from cache while revalidating in the background for up
  to a week. They keep their names, so they are not immutable.
- robots.txt, sitemap.xml: an hour.
- HTML, /sw.js and /_app/version.json keep the platform default on purpose:
  a deploy, a changed legal document and a new service worker must be
  visible on the next load.

Also documents an accepted wart: a missing asset path gets the SPA fallback
(index.html) with the path's immutable header. It only reaches a tab left
open across a deploy, which hooks.client.ts reloads once.

src/lib/cache-headers.test.ts parses _headers and pins all of it, including
that no path gets two Cache-Control rules. Verified with wrangler dev: every
path answers exactly the intended value.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 23:31:31 +07:00
poli0981 a55772f00b Merge pull request #154 from poli0981/release/v4.1.0
release: v4.1.0 — The Featherweight Edition (app 2.1.0)
2026-10-02 19:00:11 +07:00
poli0981andClaude Opus 5.5 d49c5a0ed2 release: v4.1.0 - The "Featherweight" Edition (app 2.1.0)
Web app and desktop/Android 2.0.2 -> 2.1.0 (package.json + lock, Cargo.toml
+ the f2p-tracker entry in Cargo.lock, tauri.conf.json, from which the
Android versionCode derives); repo public-facing version 4.0.2 -> 4.1.0.
CHANGELOG's Unreleased section is dated and named, and a fresh empty one
opened above it.

What 2.1.0 brings to the apps: the packed catalogue (/api/data/p1), AVIF
thumbnails and heroes, and the scrollbar setting.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 18:58:08 +07:00
poli0981 66f2c51ddb Merge pull request #153 from poli0981/feat/scrollbar-theme
feat(web): themed scrollbars with a hide setting; docs for 2026-10-02
2026-10-02 18:51:14 +07:00
poli0981andClaude Opus 5.5 ad75d4ff31 docs: bring the docs in line with what shipped on 2026-10-02
- CHANGELOG [Unreleased]: AVIF art minted into R2, the packed catalogue,
  themed and hideable scrollbars, the prerender 404 noise, uncompressed
  shards, the Tailwind scrollbar-thin collision, the thumbnail probe, the
  data-commit redeploy, and the /cdn-cgi/image billing hole.
- SECURITY_SETUP §5: zone Transformations are OFF (every /cdn-cgi/image/
  request answers 404) and the cron kept minting with them off, so the
  Images binding does not need them.
- DEPLOYMENT: shard compression depends on the `ndjson-shards` Compression
  Rule, a dashboard setting; packed files are deliberately not .jsonl.
- CLAUDE.md: the scrollbar rules (scrollbar-slim, never Tailwind's core
  scrollbar-thin; panel/page markers; the stored key), and Transformations
  must stay off.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 17:45:46 +07:00
poli0981andClaude Opus 5.5 659df7c169 feat(web): themed scrollbars, and a setting to hide them
Scrollbars now take the site's warm palette in both themes: a neutral thumb
that warms towards the brand amber on hover and turns amber while dragged,
on a transparent track. Firefox gets the standard scrollbar-color; WebKit
and Chromium get the ::-webkit-scrollbar pseudo-elements.

Why the tables never looked themed: Tailwind 4.3 ships a core
`scrollbar-thin` utility (scrollbar-width: thin), and our own utility of the
same name merged with it. In Chromium 121+ any standard scrollbar property
switches ::-webkit-scrollbar off for that element, so every panel showed the
OS's grey bar. The utility is now `scrollbar-slim`: the standard property only
for browsers without the WebKit pseudo-element, a 6 px themed bar elsewhere.
A test fails on any `scrollbar-thin` in markup (web and admin).

Settings → Scrollbars offers Visible (default) / Hidden in tables and panels
/ Hidden everywhere, stored as `f2p:scrollbars` (only once changed) and
applied as <html data-scrollbars>. Scroll containers opt in with
.scrollbar-panel (games table, card list, sidebar, command palette, the
anti-cheat table) or .scrollbar-page (the main content area); a test fails on
a themed container that opts into neither. Dialogs and the legal documents
keep their bars so a reader can see there is more. Hidden never means
unscrollable.

docs/PRIVACY_POLICY.md lists the new key, so returning visitors see the
consent gate once, showing that one line.

Verified in the dev server: table bars 6 px and themed in dark and light;
"panels" hides them (0 px) while the table still scrolls; "all" also hides
the main area; the choice survives a reload.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 17:43:54 +07:00
poli0981 65785f908a Merge pull request #152 from poli0981/fix/img-refuse-resizer
fix(img): refuse to be a source for /cdn-cgi/image/ URL transformations
2026-10-02 17:29:51 +07:00
poli0981andClaude Opus 5.5 8aaa010088 fix(img): refuse to be a source for /cdn-cgi/image/ URL transformations
With zone Transformations enabled, the zone itself is always an allowed
source and Sources cannot exclude it. /img/* proxies any Steam appid, so
/cdn-cgi/image/<any options>/img/d2/<appid>/header.jpg let anyone bill a new
transformation per option set, outside IMG_TRANSFORM_MONTHLY_CAP. Measured
in production: width=77 on app 440 answered 200 (cf-resized: internal=ok),
and wrangler tail showed the resizer fetching the source with
`Via: 1.1 image-resizing-proxy` and the caller's own User-Agent.

handleImg now answers 403 to any request whose Via names image-resizing.
The site never transforms by URL: only the cron does, through the Images
binding, from Steam directly, so nothing legitimate is refused.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 17:23:12 +07:00
poli0981 8fab0c2e7b Merge pull request #151 from poli0981/fix/img-hero-quality
fix(img): hero AVIF at q80, quality in every key, mint 40 per tick
2026-10-02 17:08:11 +07:00
poli0981andClaude Opus 5.5 42fb8e6250 fix(img): hero AVIF at q80, quality in every key, mint 40 per tick
The first production batch (10 most-played games, 2026-10-02 09:30Z) came
back at the expected sizes - median 40.0 KB JPEG -> 10.9 KB `d`, 3.4 KB `s` -
but Cloudflare's quality scale runs well below libavif's: `d` at q60 scored
SSIM 0.960 against Steam's JPEG (0.937 on Counter-Strike 2 and PUBG), and a
3x crop showed fine background stripes and texture smoothed away. The hero
is enlarged by the browser to up to 768 CSS px, so that softness shows. `s`
(q55, SSIM 0.952) is shown downscaled and stays.

- `d` goes to q80.
- The R2 key and the edge-cache key now carry width AND quality
  (img/v2/460q80/...): an old encoding can never be served for a new one by
  an edge that cached it, and changing one variant's quality re-mints only
  that variant. The v1 objects (the first 10 sources) are simply not read.
- IMG_MINT_PER_TICK 10 -> 40: the backfill finishes in about a day and a
  half, still well inside IMG_TRANSFORM_MONTHLY_CAP.

Docs: SECURITY_SETUP §5 and CLAUDE.md now say /cdn-cgi/image/ must not work
on this zone. With zone Transformations on, "This zone only" still accepts
/img/* as a source, and /img/* proxies any Steam appid, so anyone could bill
transformations with arbitrary options outside the monthly cap.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 16:39:18 +07:00
poli0981 53556a649b Merge pull request #150 from poli0981/feat/data-packs
feat(data): serve shards packed at /api/data/p1, plain stays in Git
2026-10-02 16:16:21 +07:00
poli0981 674d4f4e8e Merge pull request #149 from poli0981/feat/img-avif-r2
feat(img): AVIF header art minted by the cron into R2, served read-only
2026-10-02 16:14:52 +07:00
poli0981 31954439f5 Merge pull request #148 from poli0981/fix/prerender-404-noise
fix(web): stop the prerender from rendering 5,566 Worker-route 404s
2026-10-02 16:12:14 +07:00
poli0981andClaude Opus 5.5 4e381e734c docs(web): keep the README's pack note clear of the /img line
The image PR rewrites the /img route line directly below; inserting the
pack entry above the unchanged shard line keeps the two edits mergeable in
either order.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 16:09:46 +07:00
poli0981andClaude Opus 5.5 2cb8235d6a feat(data): serve shards packed at /api/data/p1, plain stays in Git
Phase A of making the dataset unreadable on the wire while the repository
stays its readable home. /api/data/p1/data_NNN.bin (and removed_games.bin)
is the committed file run through shared/data-pack.ts at the edge:

  "F2P\x01" | IV (first 12 bytes of its SHA-256) | AES-GCM(deflate-raw)

under a key that is PUBLIC in this repository. Obfuscation and compression,
not secrecy: curl and DevTools see an opaque blob instead of a ready-made
JSON API, and it is ~15% of the JSONL (data_001: 223,907 bytes against
1,497,828). Native WebCrypto and Compression Streams only - installed apps'
CSP has no 'wasm-unsafe-eval'.

The cache contract does not move: a pack unpacks to the exact committed
bytes, so games-loader.ts is untouched and its sha256 check against
index.json runs on the unpacked bytes before anything is cached. The Worker
verifies `?v=` before packing (the fetch-and-verify step and its mismatch
marker are now shared with the plain versioned path), caches versioned packs
immutably and unversioned ones for five minutes, and answers every error
with CORS. `.bin`, not `.jsonl`, so the zone's .jsonl Compression Rule never
recompresses a pack.

The app fetches packs when it can unpack and falls back to the plain path
for a missing pack or one that will not open - never after a network error.
The plain /api/data/data/*.jsonl paths are unchanged for released apps
(1.4.5 unversioned, 2.0.x ?v=), which cannot unpack.

Verified locally with wrangler dev: all seven shards loaded as p1 packs,
5,568 records verified and cached in IndexedDB, /games shows 5,568 of 5,568.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 16:08:25 +07:00
poli0981andClaude Opus 5.5 c4295e1264 docs(web): name the crawled image generically in the 404 comments
The game page's hero moves from /img/d2/ to /img/d/ in the AVIF change;
the comments only need to say the crawler follows an <img src="/img/...">.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 15:59:52 +07:00
poli0981andClaude Opus 5.5 2f883238aa feat(img): AVIF header art minted by the cron into R2, served read-only
/img/* used to pass Steam's JPEG straight through (median 36 KB; every
header is 460x215). Thumbnails and the detail hero are now AVIF for every
browser that accepts it: measured locally, 6.9 KB for the 460 px hero and
2.7 KB for the 230 px thumbnail of Counter-Strike 2, against a 34.3 KB JPEG.

How it is split:
- worker/lib/img-mint.ts (cron, every 15 min) is the ONLY place a billed
  transformation happens. It builds the source list from shards that hash
  to data/index.json (a lagging raw.githubusercontent shard would otherwise
  freeze a stale list under the new generation), most-played first, encodes
  `s` 230 px q55 and `d` 460 px q60 with the Images binding and writes them
  to R2 `f2p-media` under img/v1/<w>/<path>@<t>.avif. The list is kept in a
  marker object, so a backfill does not re-download the shards every tick.
- worker/routes/img.ts only READS: Cache API -> R2 -> Steam's JPEG. No
  request (unknown appid, forged ?t=, HEAD) can create a transformation or
  an R2 object. The old cf.image WebP branch is gone.
- Budget: Images Paid has no spend cap, so IMG_TRANSFORM_MONTHLY_CAP (20,000,
  at most $7.50 against the agreed $15/month) is enforced by an atomic D1
  counter (locks.ts bumpCounter), counted before each call, fail closed.
  Error 9422 stops every isolate until the month turns.

Variants: s/d are negotiated on Accept with Vary: Accept. An AVIF browser
gets the JPEG only as a provisional answer (one day, no X-Img-Final) and the
service worker now caches only X-Img-Final responses, because CacheFirst
ignores Cache-Control. t and d2 stay JPEG: released apps request them and d2
is og:image. Cache keys are normalised, so stray query strings no longer
fork the edge cache, and the t capsule probe no longer runs on hashed paths
where it was two guaranteed 404s.

Client: thumbnails use s, the hero uses d with fetchpriority="high". The
Steam URL parser moves to shared/steam-image.ts so the client, route and
cron cannot disagree. worker-configuration.d.ts regenerated (runtime types
unchanged). Bucket f2p-media already exists (created 2026-10-02).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 15:58:44 +07:00
poli0981andClaude Opus 5.5 cd18146ed2 fix(web): stop the prerender from rendering 5,566 Worker-route 404s
Every production build log was 91% `[404] GET /img/d2/<appid>/...` lines,
one per game page. The prerender crawler follows each page's
<img src="/img/d2/...">; /img/* and /api/* are Worker routes the SvelteKit
app does not contain, so each request rendered the root layout plus the
error page and SvelteKit's DEFAULT server handleError printed the line.
kit.prerender.handleHttpError only decides pass/fail and cannot silence it.

src/hooks.server.ts now answers both prefixes before routing: no render, no
log. The prerenderer still sees the 404 and handleHttpError still ignores
exactly these prefixes, so a broken internal link still fails the build.
The hook only runs at build time and under `vite dev`, whose proxy takes
/api and /img first.

Local build: 0 `[404]` lines (was 5,566), log 294 lines (was 11,590),
verify-dist --web OK (5,610 HTML files, 5,568 game pages).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 15:38:41 +07:00
github-actions[bot] 841453f056 Top online [2026-10-02 03:45] 2026-10-02 03:45:27 +00:00
github-actions[bot] d7333af462 Auto update [2026-10-02] 2026-10-02 00:23:39 +00:00
github-actions[bot] 6b398d05e1 Snapshot [2026-10-01] 2026-10-01 23:14:29 +00:00
github-actions[bot] 98703de194 Refresh store data [2026-10-01] 2026-10-01 16:51:46 +00:00
github-actions[bot] fef5f5703f Update reviews [2026-10-01] 2026-10-01 09:27:23 +00:00
github-actions[bot] 72cbbebbca chore(data): mark dead games 2026-10-01 04:41:55 +00:00
github-actions[bot] a9de498559 Ingest games [2026-10-01 03:14] 2026-10-01 03:14:35 +00:00
f2p-tracker-admin[bot] 1c51a1339d 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-10-01 03:06:19 +00:00
github-actions[bot] 4ad4efdef9 Ingest games [2026-10-01 01:17] 2026-10-01 01:17:35 +00:00
f2p-tracker-admin[bot] 226e1d8872 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-10-01 01:09:19 +00:00
github-actions[bot] 03915fe8ec Auto update [2026-10-01] 2026-10-01 00:27:18 +00:00
github-actions[bot] b8bf87e56f Snapshot [2026-09-30] 2026-09-30 23:15:53 +00:00
github-actions[bot] 722eda0b4d Refresh store data [2026-09-30] 2026-09-30 16:50:23 +00:00
github-actions[bot] d94c0e806b Top online [2026-09-30 09:49] 2026-09-30 09:49:48 +00:00
github-actions[bot] 5a9af5659f Ingest games [2026-09-30 03:35] 2026-09-30 03:35:34 +00:00
f2p-tracker-admin[bot] 2f078b8ec7 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-09-30 03:27:04 +00:00
github-actions[bot] 739a5b495f Ingest games [2026-09-30 02:39] 2026-09-30 02:39:45 +00:00
f2p-tracker-admin[bot] 90e65991e7 queue: 69 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-09-30 02:33:55 +00:00
github-actions[bot] 08814bb0f8 Auto update [2026-09-30] 2026-09-30 00:23:50 +00:00
github-actions[bot] 60c5e8c644 Snapshot [2026-09-29] 2026-09-29 23:15:35 +00:00
github-actions[bot] 4f5f3241a5 Refresh store data [2026-09-29] 2026-09-29 16:50:55 +00:00
poli0981 550ba5f44a Merge pull request #143 from poli0981/release/v4.0.2
Contact addresses + release v4.0.2 / app 2.0.2
2026-09-29 23:36:31 +07:00
poli0981andClaude Opus 5.5 62256bb97e chore(release): v4.0.2, app 2.0.2
Web app, desktop and Android 2.0.1 -> 2.0.2 (package.json and lock,
Cargo.toml, the f2p-tracker entry in Cargo.lock, tauri.conf.json); the
[Unreleased] store-refresh and push-retry entries plus the contact addresses
become v4.0.2, "The Right Address Edition".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 23:31:45 +07:00
poli0981andClaude Opus 5.5 a74a004e19 docs: publish role contact addresses and the maintainer's website
contact@ stays the default. Three role aliases go where a reader of that
document will look for them, and nowhere else:

- security@  SECURITY.md, security.txt, SECURITY_SETUP section 8
- privacy@   the Privacy Policy's "Your rights"
- copyright@ LICENSE-DATA (new "If you hold rights" section) and ToS
             section 6, one address for copyright, DMCA and takedown notices

security.txt now lists GitHub's private vulnerability reporting first and
security@ second, in RFC 9116 preference order; the links page is not a
security channel and is dropped from it. The About page gains a Website card
(https://poli0981.dev/), two columns at sm and three from md so the email
handle never truncates. AUTHORS, Contact, CONTRIBUTING and username.txt carry
the full map.

The copyright text promises a human reading, not an outcome: an override
cannot blank a field and the store refresh rewrites description monthly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 23:31:09 +07:00
github-actions[bot] 143ba40330 Update reviews [2026-09-29] 2026-09-29 15:04:31 +00:00
github-actions[bot] ed50fc605e Ingest games [2026-09-29 11:42] 2026-09-29 11:42:14 +00:00
f2p-tracker-admin[bot] f04f329404 queue: 50 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-09-29 11:38:00 +00:00
github-actions[bot] 55bb458ab6 Auto update [2026-09-29] 2026-09-29 03:51:08 +00:00
github-actions[bot] d1a625aa1e Snapshot [2026-09-29] 2026-09-29 02:31:32 +00:00
github-actions[bot] 17faea1950 Refresh store data [2026-09-28] 2026-09-28 22:14:38 +00:00
dependabot[bot] 2b0e9927ba chore(deps): Bump the actions-all group across 1 directory with 7 updates
Bumps the actions-all group with 7 updates in the / directory:

| Package | From | To |
| --- | --- | --- |
| [actions/github-script](https://github.com/actions/github-script) | `8` | `9` |
| [actions/setup-node](https://github.com/actions/setup-node) | `4` | `7` |
| [actions/upload-pages-artifact](https://github.com/actions/upload-pages-artifact) | `4` | `5` |
| [actions/setup-java](https://github.com/actions/setup-java) | `4` | `6` |
| [android-actions/setup-android](https://github.com/android-actions/setup-android) | `3` | `4` |
| [softprops/action-gh-release](https://github.com/softprops/action-gh-release) | `2` | `3` |
| [tauri-apps/tauri-action](https://github.com/tauri-apps/tauri-action) | `0` | `1` |



Updates `actions/github-script` from 8 to 9
- [Release notes](https://github.com/actions/github-script/releases)
- [Commits](https://github.com/actions/github-script/compare/v8...v9)

Updates `actions/setup-node` from 4 to 7
- [Release notes](https://github.com/actions/setup-node/releases)
- [Commits](https://github.com/actions/setup-node/compare/v4...v7)

Updates `actions/upload-pages-artifact` from 4 to 5
- [Release notes](https://github.com/actions/upload-pages-artifact/releases)
- [Commits](https://github.com/actions/upload-pages-artifact/compare/v4...v5)

Updates `actions/setup-java` from 4 to 6
- [Release notes](https://github.com/actions/setup-java/releases)
- [Commits](https://github.com/actions/setup-java/compare/v4...v6)

Updates `android-actions/setup-android` from 3 to 4
- [Release notes](https://github.com/android-actions/setup-android/releases)
- [Commits](https://github.com/android-actions/setup-android/compare/v3...v4)

Updates `softprops/action-gh-release` from 2 to 3
- [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/v2...v3)

Updates `tauri-apps/tauri-action` from 0 to 1
- [Release notes](https://github.com/tauri-apps/tauri-action/releases)
- [Changelog](https://github.com/tauri-apps/tauri-action/blob/dev/CHANGELOG.md)
- [Commits](https://github.com/tauri-apps/tauri-action/compare/v0...v1)

---
updated-dependencies:
- dependency-name: actions/github-script
  dependency-version: '9'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-all
- dependency-name: actions/setup-java
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-all
- dependency-name: actions/setup-node
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-all
- dependency-name: actions/upload-pages-artifact
  dependency-version: '5'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-all
- dependency-name: android-actions/setup-android
  dependency-version: '4'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-all
- dependency-name: softprops/action-gh-release
  dependency-version: '3'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-all
- dependency-name: tauri-apps/tauri-action
  dependency-version: '1'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions-all
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-09-28 19:29:01 +00:00
github-actions[bot] 5220da1b9d Ingest games [2026-09-28 14:45] 2026-09-28 14:45:17 +00:00
f2p-tracker-admin[bot] e62ccc5ece 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-09-28 14:37:02 +00:00
github-actions[bot] f61cd3c810 Purge unhealthy [2026-09-28] 2026-09-28 14:09:46 +00:00
github-actions[bot] 5932dd5cae chore(data): mark dead games 2026-09-28 11:07:03 +00:00
github-actions[bot] 404fd5ffd7 Ingest games [2026-09-28 09:04] 2026-09-28 09:04:53 +00:00
f2p-tracker-admin[bot] fd4d9b22af 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-09-28 08:56:39 +00:00
github-actions[bot] e962197b2f Ingest games [2026-09-28 06:21] 2026-09-28 06:21:53 +00:00
f2p-tracker-admin[bot] 2406f1d2a6 queue: 95 approved games
Approved in /admin 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-09-28 06:14:14 +00:00
github-actions[bot] 4254e668f9 Ingest games [2026-09-28 06:14] 2026-09-28 06:14:11 +00:00
f2p-tracker-admin[bot] 6d87beafb9 queue: 100 approved games
Approved in /admin by admin.

Reason: ok

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-09-28 06:06:08 +00:00
github-actions[bot] 84b0958daf Ingest games [2026-09-28 05:21] 2026-09-28 05:21:26 +00:00
f2p-tracker-admin[bot] 0f722b62f7 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-09-28 05:13:19 +00:00
github-actions[bot] 6eeebf27ab Ingest games [2026-09-28 05:11] 2026-09-28 05:11:31 +00:00
f2p-tracker-admin[bot] 66fb78ac34 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-09-28 05:03:20 +00:00
github-actions[bot] aac984b3ef Ingest games [2026-09-28 04:39] 2026-09-28 04:39:44 +00:00
f2p-tracker-admin[bot] cceae9cf0f 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-09-28 04:31:29 +00:00
github-actions[bot] 963dc9aa62 Auto update [2026-09-28] 2026-09-28 03:12:59 +00:00
github-actions[bot] cfd9d3c2a9 Snapshot [2026-09-28] 2026-09-28 01:28:47 +00:00
github-actions[bot] 1ab206812d Refresh store data [2026-09-27] 2026-09-27 20:06:20 +00:00
github-actions[bot] cdbb2a8f51 Ingest games [2026-09-27 15:54] 2026-09-27 15:54:50 +00:00
f2p-tracker-admin[bot] 908806c308 queue: 50 approved games
Approved in /admin 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-09-27 15:51:08 +00:00
github-actions[bot] b0d21c9bd0 Ingest games [2026-09-27 15:44] 2026-09-27 15:44:18 +00:00
f2p-tracker-admin[bot] cac4fe288e queue: 5 approved games
Approved in /admin 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-09-27 15:43:45 +00:00
github-actions[bot] afd024fcfd Update reviews [2026-09-27] 2026-09-27 13:55:37 +00:00
github-actions[bot] a725fb2843 Top online [2026-09-27 09:23] 2026-09-27 09:23:58 +00:00
github-actions[bot] 2133fc6428 Auto update [2026-09-27] 2026-09-27 03:16:20 +00:00
github-actions[bot] 436990a082 Ingest games [2026-09-27 03:05] 2026-09-27 03:05:14 +00:00
f2p-tracker-admin[bot] d5ebf55b4f queue: 50 approved games
Approved in /admin by admin.

Reason: ok

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-09-27 03:01:27 +00:00
github-actions[bot] 18ceb1264d Snapshot [2026-09-27] 2026-09-27 01:13:59 +00:00
github-actions[bot] a6ebda41ea Refresh store data [2026-09-26] 2026-09-26 19:32:10 +00:00
github-actions[bot] b0e0e6d25f Auto update [2026-09-26] 2026-09-26 03:09:22 +00:00
github-actions[bot] fdd58c5952 Snapshot [2026-09-26] 2026-09-26 01:20:15 +00:00
github-actions[bot] 1223111c6a Refresh store data [2026-09-25] 2026-09-25 20:20:41 +00:00
github-actions[bot] ff62388de4 Update reviews [2026-09-25] 2026-09-25 13:39:27 +00:00
github-actions[bot] 69d9931d3b Top online [2026-09-25 08:59] 2026-09-25 08:59:23 +00:00
github-actions[bot] 7c0a1c3855 Auto update [2026-09-25] 2026-09-25 03:05:24 +00:00
github-actions[bot] cbc0b7435e Snapshot [2026-09-25] 2026-09-25 01:17:34 +00:00
github-actions[bot] 33022a8b84 Refresh store data [2026-09-24] 2026-09-24 20:20:14 +00:00
github-actions[bot] cae89aa15d Ingest games [2026-09-24 14:55] 2026-09-24 14:55:22 +00:00
f2p-tracker-admin[bot] 25589d9334 queue: 19 approved games
Approved in /admin by admin.

Reason: ok

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-09-24 14:53:43 +00:00
github-actions[bot] 56e9ed6176 chore(data): mark dead games 2026-09-24 09:25:16 +00:00
github-actions[bot] cfc92b986a Auto update [2026-09-24] 2026-09-24 02:48:57 +00:00
github-actions[bot] 76a390a6e2 Snapshot [2026-09-24] 2026-09-24 01:15:12 +00:00
github-actions[bot] 0d93786d30 Refresh store data [2026-09-23] 2026-09-23 19:59:35 +00:00
poli0981 353bb9ec02 Merge pull request #141 from poli0981/feat/refresh-store-data
Refresh tags, languages and store details on a daily rotation; retry rejected data pushes
2026-09-23 22:42:37 +07:00
poli0981andClaude Opus 5.5 de9d380994 feat(pipeline): refresh tags, languages and store details on a rotation
update_data.py only enriches records that are incomplete, and fetcher.py's
apply_details()/apply_scraped() only fill EMPTY fields. Once a game had its
tags, languages, platforms or header image, nothing looked at them again
short of the manual refetch_all.py. A dry run on three games found all three
with tags that had drifted since they were first fetched.

scripts/refresh_store_data.py re-reads them a slice at a time, daily:
- store page (tags, languages, language_details, has_paid_dlc): every game
  once every 7 days;
- appdetails (name, header_image, description, developer, publisher,
  release_date, platforms, metacritic, drm_notes): every game once every
  30 days.
Measured on the live catalogue: 600-675 store pages and 121-166 appdetails
calls a day, about 40 minutes at the client's throttle, instead of ~8,800
requests in one sitting.

A game is due when crc32(appid) % cycle == day % cycle. Not appid % cycle:
Steam appids are nearly all multiples of 10, which would leave 27 of the 30
monthly slices empty.

These fields were fill-if-empty until now, so the refresh keeps the same
care: it replaces a value only with a non-empty one (a failed request or an
age-gated page changes nothing), never writes MANUAL_FIELDS or notes, reads
has_paid_dlc only from a real store page, compares description as stored
(truncated to DESCRIPTION_MAX), bumps last_updated only on a real change,
and writes through save_main() so overrides and index.json behave as for
every other job. scripts/tests/test_refresh_store_data.py pins each rule and
the even spread of the slices.

"Refresh Store Data" runs at 16:00 UTC: scheduled runs here start 2-5 hours
late, the morning data jobs run 2-4 hours, and the data-write group keeps
only one pending run, so the slot is the one nothing long overlaps. It is in
data-write, commits through bash/commit_push.sh, and is on the CI-failure
notification list. README, CLAUDE.md and the changelog describe it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 22:40:48 +07:00
poli0981andClaude Opus 5.5 5e689e7aca fix(pipeline): rebase and retry when a data job's push is rejected
purge-unhealthy ran for four hours on 2026-09-21 and then failed on
"push rejected (fetch first)", throwing the whole run away. The data-write
concurrency group serialises the WORKFLOWS, but main still moves under a
long job: a merged pull request, an /admin approval or override the Worker
commits, the extension's push to scripts/temp_info.jsonl.

bash/commit_push.sh does what every wrapper did - add, commit only if
something changed - and then pushes with up to five attempts, rebasing onto
origin/main between them. None of the other writers touch the shards, so
the rebase is clean; a genuine conflict still fails the job. All nine data
wrappers now call it, with their commit messages unchanged (snapshot.sh
keeps its data/snapshots/ pathspec).

Tested against a scratch remote: with main moved by another commit, the
first push is rejected, the rebase lands the job's commit on top, and the
retry succeeds; with nothing to commit it prints "No changes".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 22:40:23 +07:00
poli0981 abe92e2457 Merge pull request #136 from poli0981/release/v4.0.1
v4.0.1 / app 2.0.1: gate every data load behind consent and the human check
2026-09-23 22:09:26 +07:00
poli0981andClaude Opus 5.5 52dd8f5698 chore(release): v4.0.1, app 2.0.1
Web app and desktop/Android 2.0.0 -> 2.0.1 (package.json and its lockfile,
Cargo.toml and Cargo.lock, tauri.conf.json - the Android versionCode is
derived from it at build time); repo public-facing version 4.0.0 -> 4.0.1.
The changelog's Unreleased section becomes v4.0.1, "The Human Check
Edition": the Turnstile check, legal diffs, Web Analytics, the no-Referer
artwork fix for the apps, and data loads held behind both first-run gates.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 22:02:19 +07:00
poli0981andClaude Opus 5.5 197bc6f064 fix(web): no page loads data before consent and the human check
The root layout held the catalogue back until consent (and, since the
Turnstile change, the human check), but two pages did not:
/activity and /charts/delisted called load() from $effects of their own,
and the activity feed also refetched on window focus - so both fetched
before the reader had accepted anything.

The gate now lives in Resource itself. An `enabled` option is read at the
top of every load() - the focus refetch and Retry included - and because it
is read inside load(), an $effect that calls load() subscribes to it and
runs again when it turns true: a held-back load starts by itself once the
reader is through. lib/app-ready.ts defines appReady() (consent accepted
AND the check cleared, which the packaged apps do as soon as they hydrate),
the root layout uses it for its own effects, and every Resource passes it.

resource.test.ts checks the option (no load, focus refetch or retry while
closed; open by default), fails on any `new Resource` in src without
`enabled: appReady`, and pins the layout's gated effect. Verified in a
browser: /activity before consent makes no /api/activity request, even on
a focus event; after consent and the check it loads once, by itself.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 22:01:50 +07:00
poli0981andClaude Opus 5.5 fa8b81fd9b docs: the Turnstile check and the Referer fix, and what they made untrue
Legal (both reopen the consent gate for returning visitors, showing only
the changed lines - edited line-locally so that diff stays small):
- PRIVACY_POLICY: a section on the website's Turnstile check - after
  acceptance, at most daily, what challenges.cloudflare.com reads (IP,
  User-Agent, TLS fingerprint, page signals), that Cloudflare is processor
  for the site and controller where it improves its bot detection (the
  Turnstile Privacy Addendum), that the Worker forwards the token and IP
  and keeps neither; the f2p:human_check storage row. "The only third
  party", "the verification step" and "No fingerprinting" are corrected.
- ToS section 9: the check exists; /api/data/*, /img/* and the apps stay
  excluded from both human checks.

SECURITY_SETUP:
- section 10 rewritten. It said the apps survived Hotlink Protection only
  because their webview sent no Referer (untrue since WebView2 started
  sending tauri.localhost), recommended switching the protection off, and
  said no allowlist could express the apps' origin - a Configuration Rule
  on http.referer can. Now: the per-<img> fix and its test, the rule for
  2.0.0 installs, and the check, with the results measured today.
- new section 12: widget settings (hostname, Managed, pre-clearance off),
  the TURNSTILE_SECRET secret and rotation, what the check is not, local
  testing with Cloudflare's test keys, the optional rate-limit expression.
- the CSP block, the script-src/frame-src prose, "no form posts", the
  rule budget (Configuration Rules 1/10), and two stale paths.

CLAUDE.md gains the human-check and <img> invariants and says "after
consent and the human check" where the service worker, analytics and
/welcome used to say "after consent". README, web/README, DEPLOYMENT,
ACKNOWLEDGEMENTs, SECURITY (bypassing the client-side gate is out of
scope), TAURI troubleshooting and the changelog follow. _headers and
worker/lib/http.ts: comments only - why images override Referrer-Policy,
what X-Frame-Options does and does not govern, and the public/_headers
and SITE_ORIGIN references that were stale.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 21:47:01 +07:00
poli0981andClaude Opus 5.5 909c276816 feat(web): a Cloudflare Turnstile human check after consent, web only
After accepting the terms, each browser now passes a Turnstile widget -
at most once every 24 hours - before the app loads its data. It is an
OVERLAY (lib/common/HumanCheck.svelte), for the consent gate's reason: the
prerendered page underneath is what crawlers index. It opens only after
its state has read storage, so it is never baked into a page, and never
together with the consent gate, because it needs consent.accepted.
Crawlers never consent, so they never meet it.

Soft by design, and lib/human-check.ts says so at the top: it keeps
automated browsers from using the app, and cannot stop anything that reads
the HTML or the API directly - the WAF rules stay the boundary. It
refuses only on a verdict (the Worker's 403, a 300xxx/600xxx widget
error). Everything that is the site's fault - no secret, siteverify down,
a widget configuration error such as an unlisted hostname - and being
offline let the reader through for that page load, unrecorded, so an
installed web app still opens with no network.

- lib/human-check.ts: the pure rules, tested without Svelte - where it
  runs (never under Tauri, `npm run dev` or an empty site key), which key
  (the real one on the production hostname only, Cloudflare's always-pass
  test key elsewhere), pass validity and TTL clamping, and what each reply
  and widget error code means.
- lib/human-check-state.svelte.ts: `cleared`, a pass kept in memory as
  well as in f2p:human_check, re-read when the tab becomes visible or
  another tab stores one.
- lib/turnstile.ts: api.js from Cloudflare's exact URL, once; a timed-out
  script is waited on rather than duplicated, a failed one is replaced.
- lib/gates.ts: /error/* and /legal/* are exempt from both gates, in one
  place instead of ConsentGate's private regex.
- The root layout starts the catalogue, the service worker, analytics and
  the /welcome redirect only when consent.accepted && humanCheck.cleared.
- kit.csp, web flavour only: challenges.cloudflare.com in script-src and a
  new frame-src (the widget is an iframe; frames otherwise fall back to
  default-src 'self'). The Tauri policy is unchanged, with no frame-src.
- verify-dist.mjs: the web build must allow Turnstile in both directives,
  the Tauri build in neither, and no prerendered page may contain the
  check's title.

Verified in a browser against `wrangler dev` with the test keys: nothing
from challenges.cloudflare.com before consent; consent -> widget -> one
POST (200) -> pass stored ~24 h ahead -> /welcome; reload within 24 h
does not ask again; /legal/* stays readable with an expired pass; the
always-fail secret shows the refusal with its code, and Retry sends a
fresh token; no secret lets the page through without storing a pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 21:47:01 +07:00
poli0981andClaude Opus 5.5 40e83b17dc feat(worker): verify the web app's Turnstile token at POST /api/human-check
The website is about to ask each browser to pass Cloudflare Turnstile. A
widget token proves nothing until siteverify confirms it, and the secret
that call needs cannot live in the page - so the page posts the token here
and gets a yes or no. That answer is ALL this produces: no cookie, no
session, nothing stored. The pages are prerendered and served without the
Worker, and docs/ToS.md section 9 promises that /api/data/*, /img/* and the
packaged apps are never human-checked, so nothing on the server could or
may require a pass.

- Same-origin only: POST, Origin equal to the request's own, Sec-Fetch-Site
  (when sent) same-origin, JSON. No CORS - the apps never run the check.
- The body is read from the stream with a 4 KB cap, because a chunked
  request carries no Content-Length; the JSON is parsed locally because a
  SyntaxError message would quote the token into the logs.
- siteverify gets the secret, the token and CF-Connecting-IP, with an 8 s
  timeout. The action ("enter", shared/human-check.ts, one definition for
  both halves) and the hostname must match, except under Cloudflare's
  published TEST secrets, whose answers are fixed ("localhost", "test").
- Statuses are chosen for the page, which refuses only on a verdict: 403
  when Cloudflare said no; 503 without TURNSTILE_SECRET, so deploy order
  never matters, or when a test widget's fixed token meets the real secret
  (the site served on a hostname the widget does not know); 502 when
  siteverify is unreachable, failing or garbled.
- Never logs the token or the IP; the tests spy on console to hold that.

TURNSTILE_SECRET is declared required in env.d.ts (an optional declaration
would clash with what `wrangler types` emits once .dev.vars defines it) and
checked at runtime. web/.dev.vars.example carries Cloudflare's always-pass
test secret for `wrangler dev`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 21:47:01 +07:00
poli0981andClaude Opus 5.5 cc10ec8c2c fix(web): send no Referer for artwork, so Hotlink Protection stops blanking the apps
Every game image in the desktop app was a broken icon. Security Events
showed why: WebView2 sends the page origin as the Referer
(http://tauri.localhost/), and the zone's Hotlink Protection 403s /img/*
for any Referer that is not this site - at the edge, before the Worker
runs, so nothing in worker/ could see or answer it. Android's System
WebView sends the same origin. docs/SECURITY_SETUP.md had predicted exactly
this ("the apps survive only because the webview sends no Referer").

Hotlink Protection lets a request with NO Referer through, so every <img>
now carries a literal referrerpolicy="no-referrer" - the admin's Thumb
already did. On the web the requests are same-origin and passed anyway;
the attribute also fixes the thumbnails `npm run dev` could never show
through its production proxy. Measured in Chromium against production from
a foreign origin: default policy -> blocked, no-referrer -> loads.

src/lib/images.test.ts scans every .svelte file (app and admin) with a
brace- and quote-aware tag scanner - an arrow function's "=>" would end a
naive <img[^>]*> match early - and fails on an <img> without the attribute,
or if it finds fewer than eleven.

Installed 2.0.0 apps are covered by a Configuration Rule on the zone
(documented in the docs commit) until they update.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 21:47:01 +07:00
github-actions[bot] 899629792a Update reviews [2026-09-23] 2026-09-23 13:14:08 +00:00
github-actions[bot] db93d95faa Top online [2026-09-23 08:43] 2026-09-23 08:43:45 +00:00
github-actions[bot] bd38e136ff Auto update [2026-09-23] 2026-09-23 02:58:18 +00:00
github-actions[bot] e4ccfdcbde Snapshot [2026-09-23] 2026-09-23 01:20:42 +00:00
github-actions[bot] 11797de42e Auto update [2026-09-22] 2026-09-22 02:58:24 +00:00
github-actions[bot] 2bddfd284a Snapshot [2026-09-22] 2026-09-22 01:31:05 +00:00
github-actions[bot] b758b795e3 Ingest games [2026-09-21 14:23] 2026-09-21 14:23:15 +00:00
f2p-tracker-admin[bot] 9c86248151 queue: 4 approved games
Approved in /admin 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-09-21 12:23:58 +00:00
github-actions[bot] 0344db8206 Dead link check [2026-09-21] 2026-09-21 11:56:02 +00:00
f2p-tracker-admin[bot] 9256c2c80e override: 8 games (genre)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-21 03:46:58 +00:00
f2p-tracker-admin[bot] a1bf386d39 override: 4 games (genre)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-21 03:30:26 +00:00
f2p-tracker-admin[bot] 8dbd0227d8 override: Selena's Charm 2: Enchanted Garden (genre)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-21 03:11:47 +00:00
f2p-tracker-admin[bot] 53430f1f03 override: Step Lightly (genre)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-21 03:11:01 +00:00
f2p-tracker-admin[bot] a02c6a36b9 override: Where Are My Cats? (genre)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-21 03:09:45 +00:00
github-actions[bot] 7f1474b3f0 Auto update [2026-09-21] 2026-09-21 02:58:09 +00:00
f2p-tracker-admin[bot] 76bb58149a override: tiny desktop pals (genre)
Edited in /admin by admin.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-21 02:08:04 +00:00
github-actions[bot] a15d2d5595 Snapshot [2026-09-21] 2026-09-21 00:56:24 +00:00
github-actions[bot] a8dc898278 Ingest games [2026-09-20 23:55] 2026-09-20 23:55:30 +00:00
f2p-tracker-admin[bot] c278b74415 queue: 50 approved games
Approved in /admin 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-09-20 23:51:19 +00:00
github-actions[bot] 34a2a01e00 Ingest games [2026-09-20 16:23] 2026-09-20 16:23:06 +00:00
f2p-tracker-admin[bot] 2a2d5c59af queue: 50 approved games
Approved in /admin 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-09-20 16:18:58 +00:00
github-actions[bot] 9df812535d Ingest games [2026-09-20 13:34] 2026-09-20 13:34:52 +00:00
f2p-tracker-admin[bot] 5baaa7221a queue: 3 approved games
Approved in /admin by admin.

Reason: ok

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-09-20 13:34:28 +00:00
poli0981andClaude Opus 5 7d0025112b docs: record the WAF rules as live, and replace the React-era dependency list
THE TWO WAF RULES EXIST NOW. `human-check-pages` (Managed Challenge) and
`blocked-countries` (Block) went live 2026-09-20, so SECURITY_SETUP no
longer reads as instructions for something that has not been done. Section
4 says what is deployed and when, and carries what was measured afterwards:
a plain curl with no browser User-Agent is still served `/`, `/games`,
`/legal/tos`, `/.well-known/security.txt`, `/sitemap.xml` and `/robots.txt`,
the challenge rate has stayed at 0%, and a real browser loads a game page,
the service worker and the beacon uninterrupted. Section 9 records the
analytics beacon returning 200 and its reports 204 on the live site, and
that "Enable with JS Snippet installation" is the only mode this CSP can
ever accept. "Still open" now names the Free-plan rule budget - 1/1 rate
limiting, 2/5 custom - because that is the next thing to run out.

THE DEPENDENCY LIST WAS THE REACT APP'S. ACKNOWLEDGEMENTs credited React 18,
react-router, i18next, Zustand, TanStack Query, Radix, shadcn/ui, cmdk,
OpenPGP.js, Tailwind 3, TypeScript 5 and PostCSS - none of which has
shipped since the v4 rewrite - while omitting Svelte, SvelteKit, Bits UI,
unified and the typefaces that actually do. Rewritten from package.json and
Cargo.toml, with every licence read out of node_modules rather than
remembered: echarts-wordcloud is ISC, not BSD-3-Clause. The claim that
/about carries a "full SPDX list" is gone; it is a curated subset and says
so now.

THIRD_PARTY.md gains svelte-check and vitest, which the pre-publish suite
has been running unlisted, and drops "the TypeScript SPA".

web/README.md documents the two analytics CSP hosts, why automatic
injection can never be used, the navigateFallback fix, and the consent
hashing and diff mechanism - none of which existed when its CSP and PWA
sections were written. Its file tree lists the four new modules.

DEPLOYMENT.md records that a zero-duration "Workers Builds" failure on a PR
branch is a preview-build artefact: it happened twice on PR #130 while the
identical commits deployed from main minutes later, and the GitHub Actions
`check` job already runs the same build, verify-dist and wrangler dry-run.

Also fixes a pre-existing broken curl snippet in section 10, whose
`%{http_code}\n` had been saved with a literal newline in it.

The dead relative links the link checker finds in CHANGELOG.md are left
alone: they are in released sections and name files that existed at the
time. A changelog is a record, not documentation.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 20:21:58 +07:00
poli0981andClaude Opus 5 2a4639135c fix(ci): CodeQL read the new CSP assertions as URL substring checks
`cspSources(...).includes(host)` is an ARRAY includes - an exact element
match - but CodeQL cannot tell it from `String.prototype.includes` and
filed two high-severity `js/incomplete-url-substring-sanitization` alerts,
failing the PR.

The worry it encodes is a real one for this file, which is why the Tauri
assertion right below was already written as `.some(source => source ===
...)` with a comment saying so. Both now go through one `cspAllows()`
helper, so a reader and an analyser reach the same conclusion and
`https://evil.example/?x=https://cloudflareinsights.com` cannot pass.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 20:01:28 +07:00
poli0981andClaude Opus 5 5dfd9dd36e docs: analytics, the two WAF rules, and the claims they made false
The privacy policy said the site had no analytics, set no cookies, loaded
nothing from a third party and did not have Cloudflare Web Analytics
enabled. Three of those were already shaky and all four had to change, so
this rewrites the affected sections rather than bolting a paragraph on:
what the beacon does and does not do, why it waits for consent, the
human-verification step, and where the site is no longer served. ToS gains
section 9, which did not exist - there was no availability or automated-
access clause at all.

SECURITY_SETUP section 9 is reversed. It recommended turning Web Analytics
OFF; it now records why the automatic mode can never work under a
hash-based CSP, so nobody re-enables it, and what the JS-snippet setup is.
Section 4 keeps "leave Bot Fight Mode off" and adds the two custom rules
that are safe here, each exclusion annotated with what breaks without it,
plus the country block with its real costs: Yandex indexing ends, the
packaged apps stop working there, VPNs evade it trivially.

The verification command for the country block is deliberately NOT the
obvious one. `-H 'CF-IPCountry: CN'` proves nothing: geo.ts reads
request.cf.country first, which cannot be spoofed, and Cloudflare
overwrites that header on ingress. The doc gives the two checks that do
prove something, including the local one whose expected result is 403 on
every Worker route AND 200 on / - which is the whole argument for the WAF
rule.

Also corrected: the CSP transcribed in section 1 was missing both new hosts
and still listed a frame-ancestors this policy has never carried (it is
ignored in a meta CSP; X-Frame-Options covers it).

CLAUDE.md gains four standing rules - the navigateFallback invariant, the
two web-only CSP hosts and why automatic injection is impossible,
per-document consent hashing and why it lives outside prefs.svelte.ts, and
BLOCKED_COUNTRIES being defence in depth rather than the boundary.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 20:01:28 +07:00
poli0981andClaude Opus 5 c9344ab685 feat(web): a working service worker, analytics after consent, and legal diffs
Three changes to the public app, sharing vite.config.ts, verify-dist.mjs
and the root layout.

THE SERVICE WORKER NEVER WORKED. `navigateFallback: "/200.html"` named the
adapter-static fallback, which generateFallback() writes into dist/ AFTER
workbox has globbed .svelte-kit/output - there is no 200.html under
.svelte-kit at all, so it could never be a precache entry.
createHandlerBoundToURL() threw `non-precached-url` on every page load and
abandoned the rest of the worker's top-level setup. It is now "/", which IS
precached and is exactly what Cloudflare and Tauri already serve for an
unmatched path, so lib/fallback-route.ts recovers the route offline the
same way it does online. Measured with the server stopped: /games/730
renders the game, not the dashboard. verify-dist.mjs now parses dist/sw.js
and fails the build if the bound URL is not in the manifest - nothing
looked at the worker's contents before.

CLOUDFLARE WEB ANALYTICS, and not the way it was configured. Automatic
injection had been enabled for months and collected nothing: it inserts an
inline loader at the edge, after our response, and kit.csp runs in
mode:"hash", where CSP3 makes script-src ignore 'unsafe-inline'. No policy
can ever admit it. lib/analytics.ts appends the beacon itself, from the
$effect that already waits on consent.accepted, never under Tauri, and does
nothing when CF_BEACON_TOKEN is empty. The CSP gains
static.cloudflareinsights.com (script-src) and cloudflareinsights.com
(connect-src) in the WEB flavour only; verify-dist.mjs fails the web build
without them and the Tauri build with them. The dashboard must be switched
to "Enable with JS Snippet installation" or the edge injection returns on
top of this one.

A LEGAL DOCUMENT THAT CHANGES NOW SHOWS THE CHANGE. Each document is
hashed at build time (build/legal-versions.ts serves virtual:legal-versions,
~700 bytes inlined, and virtual:legal-sources, 25 KB imported dynamically
by ConsentGate alone so a normal page load never fetches it). A differing
hash reopens the gate by itself, listing only those documents with a
line diff (lib/diff.ts) against a snapshot in f2p:legal_snapshot, rendered
as text in a <pre> and never {@html}. No snapshot - storage cleared, or an
acceptance older than the feature - falls back to "open it and read it in
full". TERMS_VERSION survives only as the "make everyone re-read all six"
override; it no longer has to be remembered for an ordinary edit.

Consent moved to lib/consent.svelte.ts: prefs.svelte.ts is also compiled by
the admin SPA's own Vite build, which cannot resolve a virtual module, and
leaving it there failed `npm run build:admin` outright.

Also fixes a layout bug the longer privacy hint exposed: the gate's hint
span had no min-w-0, so a flex item's min-width:auto let it claim the whole
row and collapse the document's LABEL to nothing - "Privacy Policy" was
invisible.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 20:01:28 +07:00
poli0981andClaude Opus 5 eb13967dfb feat(worker): refuse the blocked countries in code, as defence in depth
BLOCKED_COUNTRIES ("CN,RU,AR") in wrangler.jsonc, enforced by lib/geo.ts
before any route runs, admin block included. "CN" is mainland China only -
HK, MO and TW are separate codes and stay reachable.

This is NOT the boundary, and the comments say so in both places. The
Worker only ever sees the four `assets.run_worker_first` prefixes, so every
prerendered page is served without invoking it: measured with the list
temporarily extended, all of /api/*, /img/* and /admin answer 403 while /
still answers 200. A WAF custom rule on the zone is what actually blocks a
country (docs/SECURITY_SETUP.md section 4). What this adds is a list that
is reviewable in Git and a refusal that survives the rule being deleted or
mis-scoped.

It FAILS OPEN on an unknown country. request.cf is undefined under Vitest
and under `wrangler dev` without --remote, so failing closed would 403
every test and every local run. request.cf.country wins over CF-IPCountry,
which is why a spoofed header proves nothing - `wrangler dev` supplies its
own cf with country "SG", measured. T1 (Tor) and XX (unplaceable) are
explicitly not countries: XX has the shape of one, so without naming it a
blocklist containing "XX" would quietly refuse everyone the edge could not
locate.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 20:01:28 +07:00
poli0981andClaude Opus 5 4e206cb64c fix(admin): /admin wrote the maintainer's address into public Git
Every approval committed `Approved in /admin by <email>.`, every override
edit `Edited in /admin by <email>.`, and `data/overrides/<appid>.json`
recorded the same address as `set_by`. All three are public forever, and
the Git AUTHOR was already the App's own bot identity - only the body text
named a person.

They now say `admin` (ADMIN_ATTRIBUTION, shared/admin-api.ts). The four
override files that already carried the address are rewritten; `set_by` is
informational, so nothing in the pipeline reads it.

appendLinks() loses its `actor` PARAMETER rather than merely stopping at
the one call site that passed `who.email`: a parameter nobody can supply
cannot be supplied by mistake. A new case in git-commit.test.ts asserts the
generated body contains no `@` at all.

D1 is untouched and still records the acting Access identity in
audit_log.actor, ingest_queue.decided_by, ingest_decisions.decided_by and
commit_jobs.requested_by - 0001_init.sql calls that deliberate, and the
audit view filters on it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 20:01:28 +07:00
github-actions[bot] 41882a84b4 Top online [2026-09-20 08:43] 2026-09-20 08:43:05 +00:00
github-actions[bot] 30c63fd42f Auto update [2026-09-20] 2026-09-20 03:00:44 +00:00
github-actions[bot] 602d4e195d Ingest games [2026-09-20 01:33] 2026-09-20 01:33:15 +00:00
f2p-tracker-admin[bot] 2637653a8d queue: 9 approved games
Approved in /admin by k30021424@gmail.com.

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-09-20 01:32:20 +00:00
github-actions[bot] adbe8a83ce Snapshot [2026-09-20] 2026-09-20 00:51:36 +00:00
github-actions[bot] 05ad2a029a Update reviews [2026-09-19] 2026-09-19 12:43:49 +00:00
github-actions[bot] d156310ef6 Ingest games [2026-09-19 07:00] 2026-09-19 07:00:17 +00:00
f2p-tracker-admin[bot] 770ed488df queue: 43 approved games
Approved in /admin by k30021424@gmail.com.

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-09-19 06:56:44 +00:00
github-actions[bot] 47647b086c Ingest games [2026-09-19 06:45] 2026-09-19 06:45:41 +00:00
f2p-tracker-admin[bot] 5fcfe4f1a9 queue: 100 approved games
Approved in /admin by k30021424@gmail.com.

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-09-19 06:37:33 +00:00
github-actions[bot] ea9e864141 Ingest games [2026-09-19 06:06] 2026-09-19 06:06:50 +00:00
f2p-tracker-admin[bot] d8d7aa13fa queue: 50 approved games
Approved in /admin by k30021424@gmail.com.

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-09-19 06:02:43 +00:00
github-actions[bot] 703fdc48e2 Ingest games [2026-09-19 05:54] 2026-09-19 05:54:38 +00:00
f2p-tracker-admin[bot] 50a91b77cf queue: 100 approved games
Approved in /admin by k30021424@gmail.com.

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-09-19 05:46:39 +00:00
github-actions[bot] 23be0f1d3b Auto update [2026-09-19] 2026-09-19 02:48:37 +00:00
github-actions[bot] 5984c38528 Ingest games [2026-09-19 02:24] 2026-09-19 02:24:29 +00:00
f2p-tracker-admin[bot] 207a352aea queue: 100 approved games
Approved in /admin by k30021424@gmail.com.

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-09-19 02:16:21 +00:00
github-actions[bot] d451dc56ee Snapshot [2026-09-19] 2026-09-19 01:03:09 +00:00
github-actions[bot] d4f7a6082d Top online [2026-09-18 08:21] 2026-09-18 08:21:52 +00:00
github-actions[bot] 8fc432875b Ingest games [2026-09-18 07:32] 2026-09-18 07:32:15 +00:00
f2p-tracker-admin[bot] 025db38c5a queue: 50 approved games
Approved in /admin by k30021424@gmail.com.

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-09-18 07:28:00 +00:00
github-actions[bot] 3f374413be Ingest games [2026-09-18 05:55] 2026-09-18 05:55:18 +00:00
f2p-tracker-admin[bot] 39bf6949e1 queue: 50 approved games
Approved in /admin by k30021424@gmail.com.

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-09-18 05:51:09 +00:00
github-actions[bot] b287137b9f Ingest games [2026-09-18 05:18] 2026-09-18 05:18:53 +00:00
f2p-tracker-admin[bot] 7ff398f455 queue: 50 approved games
Approved in /admin by k30021424@gmail.com.

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-09-18 05:14:48 +00:00
github-actions[bot] 402afacbf3 Ingest games [2026-09-18 04:56] 2026-09-18 04:56:07 +00:00
f2p-tracker-admin[bot] b8fd7874e2 queue: 50 approved games
Approved in /admin by k30021424@gmail.com.

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-09-18 04:51:23 +00:00
poli0981andClaude Opus 5 fd4a6932cb docs(changelog): unreleased - admin session fix, CodeQL, release CI
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 11:39:13 +07:00
poli0981andClaude Opus 5 eebc964a31 fix: resolve CodeQL alerts #5, #6 and #7
#5 py/incomplete-url-substring-sanitization: _describe_access_redirect()
took any host ending in "cloudflareaccess.com" for an Access login page,
lookalikes such as evilcloudflareaccess.com included. The suffix now needs
the dot; test_discover_new.py covers both cases.

#6, #7 js/incomplete-multi-character-sanitization: the SEO and chart tests
stripped comments from source with a regex replace of "<!--". The i18n test
had its own copy, and its earlier fix (replace until nothing changes) removed
text that was never inside a comment. All three now use one scanner,
src/lib/testing/source.ts, which removes each span once and never rescans its
own output.

#3 js/missing-origin-check stays as it is: jsonl-parser.ts is a dedicated
module worker, only the document that created it can post to it, and its
MessageEvent.origin is empty. The file already says so, and it validates the
message shape instead.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 11:39:12 +07:00
poli0981andClaude Opus 5 0a4c5013c5 fix(admin): serve the admin API under /admin, in the page's Access app
/admin reported "Your Cloudflare Access session has expired" straight after
signing in, in a private window too. The page and its API were two Cloudflare
Access applications: /admin (AUD ca93...) and /api/admin (AUD a15d..., read
from the kid= of each login redirect). Access issues its session cookie per
application and fetch() cannot follow the sign-in redirect, so the session
for /admin never reached the API. Every call came back as an opaque redirect,
which api.ts correctly reads as an expired session, and a reload only renewed
the page's session. The Worker never answers 401/403 on these routes, so the
redirect could only have come from the edge.

The API now lives at /admin/api/*, under the page's own application:
ADMIN_API_PREFIX in shared/admin-routes.ts, used by the router, both
handlers, the SPA's api() (views pass routes like "queue?...") and the mock
backend. /api/admin/* is no longer served, and its AUD leaves
ACCESS_AUD_ADMIN.

Every existing test called the handlers directly, so none could see this.
worker/index.test.ts drives the real router and Access check with a signed
RS256 token: a reviewer reaches /admin/api/*, a write still needs the header
rather than the cookie alone, another application's token and the old prefix
both get 404. security.test.ts keeps the prefix under /admin and API paths
out of the views. Verified in preview:admin under the production CSP: queue,
stats, me, health and the ping write all answer from /admin/api/*.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 11:38:30 +07:00
poli0981andClaude Opus 5 8702060b51 ci(codeql): scan when .mjs or .cjs files change
CodeQL analyses .mjs files (alerts #16 and #17 are in
web/scripts/verify-dist.mjs), but the push and pull_request path filters
listed only .js/.jsx, so the commit that fixed those alerts never started a
scan and they stayed open.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 10:27:08 +07:00
poli0981andClaude Opus 5 411eb38957 fix(ci): find script and style elements in verify-dist by scanning
Clears CodeQL alerts #16 and #17. visible() removed <script> and <style>
with repeated regex replacement (js/incomplete-multi-character-sanitization),
and the Tauri CSP check looked the site origin up with includes(), which
CodeQL reads as a URL substring check.

The scanner lowercases ASCII only: a character whose lowercase is longer
("İ") would otherwise shift every index it cuts at. On all 3,691 pages of
the current web build it returns exactly what the regex version returned.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 10:23:54 +07:00
poli0981andClaude Opus 5 0ad53b5136 ci(android): build the released tag and install platform-tools only
android-v2.0.0 stopped at "Set up Android SDK": setup-android's default
package list still names the legacy `tools` package, which the SDK
repository no longer carries. Install platform-tools only; Gradle fetches
the build-tools and platform it needs.

A manual run now checks out the tag it releases instead of main, and the
release notes name that commit (on a manual run github.sha is main's HEAD).
The tag input has no default any more, because a run replaces the named
release's APK. The notes also stop claiming device testing for a build that
has not been tested yet; docs/android-support.md keeps the device list.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 10:23:35 +07:00
github-actions[bot] 06b91b7343 Auto update [2026-09-18] 2026-09-18 02:50:05 +00:00
github-actions[bot] 029ea7935f Snapshot [2026-09-18] 2026-09-18 01:08:37 +00:00
poli0981andClaude Opus 5 96c3e02016 fix(ci): resolve the seven CodeQL alerts in build and test tooling
None of these reach the site - they read our own build output and source
files - but the PR's CodeQL check fails on them, and each has a correct form:

- verify-dist.mjs: strip <script>/<style> until nothing changes, and accept end
  tags with trailing whitespace (incomplete multi-character sanitization, bad
  tag filter); check the Tauri origin as an exact connect-src source parsed
  from the CSP rather than a substring of the page (incomplete URL substring
  sanitization); list files with Dirent types instead of stat-then-read.
- emit-worker-bundle.ts: count scripts case-insensitively, with the same end
  tag rule, so a second script cannot slip past the one-script check.
- i18n.test.ts: strip HTML comments until nothing changes.
- fallback-route.test.ts: take the entry type from the directory listing
  instead of a stat followed by a read (file system race).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 23:35:39 +07:00
poli0981andClaude Opus 5 eeae820e0a fix(admin): build the admin bundle on a clean checkout
Web CI failed on the PR at `npm run build:admin` with ENOENT for
.admin-build/index.html. Two faults, one hiding the other:

- The admin build imports files under web/src, whose tsconfig.json extends
  .svelte-kit/tsconfig.json. On a fresh checkout that file does not exist until
  SvelteKit has synced, and CI runs typecheck (which starts with build:admin)
  before anything else. build:admin and dev:admin now run `svelte-kit sync`
  first. Workers Builds was unaffected: its `npm run build` runs the SvelteKit
  build, which syncs, before the admin build.
- The emitter read the output directory in `closeBundle`, which Vite also calls
  after a FAILED build. Its ENOENT replaced the real error in the log, and on a
  machine with an earlier build it could have read that build's files. It now
  takes the output from the bundle in `writeBundle`, which only runs after a
  successful write.

Reproduced locally by removing .svelte-kit, .admin-build and worker/generated:
the old code failed exactly as CI did (294 modules, then ENOENT); with the fix
typecheck, the 240 tests, build, verify-dist, the wrangler dry run and knip
pass from that state.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 23:30:48 +07:00
poli0981andClaude Opus 5 1b10b33a40 docs: describe v4.0.0 as it is - README, web README, Tauri, security, changelog
- README: SvelteKit rather than React, Cloudflare rather than GitHub Pages, a
  resizable self-updating desktop app, the /admin review queue, the real
  workflow list, and no in-browser editing or GPG signing (removed in
  September).
- web/README.md: the admin app, verified shard generations, prerendered game
  pages, the service worker as it is now, and the checks CI runs.
- TAURI.md: the update feed at /api/updates/desktop (drafts are never offered),
  settings surviving updates, the Android update check; the OAuth note is gone
  with sign-in.
- dev_env (en, vi), CONTRIBUTING, android-support (en, vi): tests exist now,
  and the web side is Svelte.
- SECURITY_SETUP: the admin shell's nonce policy, and the report-only CSP that
  Cloudflare's Continuous script monitoring adds at the edge (turn it off).
- CLAUDE.md: where old /#/ links still come from and why the upgrade uses
  goto; /api/activity sends CORS too.
- CHANGELOG [v4.0.0]: the admin app, verified data, a page per game, the
  installable web app, the desktop updater, the new pages, and the live-site
  fixes. Deploying needs D1 migration 0002.
- Code comments that still described React, GitHub Pages, hash routing or a
  sign-in token.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 23:13:17 +07:00
poli0981andClaude Opus 5 f8c77750f7 chore(i18n): drop 137 unused keys, translate what was copied, and test for both
The locale files still carried the React app's sign-in, GPG, bulk-delete,
maintenance-trigger and per-chart title keys, none of them asked for by
anything: 137 of 530. They are removed, and i18n.test.ts now fails when an
English key is not used anywhere in the app.

Seven Vietnamese values were the English copied across (Developer, Publisher,
Repository, a column header, the offline badge); they are translated. A second
test fails on the next one, with an explicit allowlist for what is meant to be
identical: product names, gaming terms Vietnamese uses as they are, and formats.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 23:13:16 +07:00
poli0981andClaude Opus 5 e68ea6bc1c feat(web): finish the public pages - welcome, legal index, quiet games, growth, filters in the URL
Welcome
- The full introduction: three ways in, the language switch, the documents
  just accepted, and the reshow hint (eleven keys that nothing rendered).
- Shown once, to a visit that started on the dashboard, right after consent.
  replaceState, and the page marks itself seen on mount, so Back cannot loop.
  Crawlers never consent, so / stays the indexable page.

Legal
- /legal lists every document, binding ones first.
- An unknown /legal/<slug> matches no route (param matcher) and gets the
  translated 404; the host's fallback used to hydrate it as the dashboard.
- Document titles and summaries are i18n keys; they were English everywhere,
  including the consent step.
- The rendered document no longer repeats its own title as a second <h1>.

Data views
- /stats: when games went quiet, by month (zero_player_since).
- /charts/time: catalogue growth - games added per month and the running total,
  with empty months kept on the axis.
- /charts/anti-cheat/list: a searchable, sortable table with anti-cheat families
  as filters and the kernel level per game.
- /health: safe = "?" is its own "not reviewed yet" group instead of burying
  the genuinely missing fields under 3,600 of them; groups link to the matching
  filtered /games view.

/games
- Safety filter (safe, not safe, not reviewed, never set), normalised the same
  way on /games, /stats and /health (lib/safety.ts).
- Filters, sort and page are mirrored into the URL, browser-only, so a filtered
  view can be linked and survives a reload.
- The page number lives in the filter store: Back from a game returns to the
  same page, and a changed filter starts again at page 1.

Also translated: the table's data-issue tooltips and the About page's stack
descriptions.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 23:04:20 +07:00
poli0981andClaude Opus 5 727aadabf8 feat(admin): a Svelte admin app embedded in the Worker, with read-only decided rows
The two Worker-rendered admin pages (admin-ui.ts, edit-ui.ts: 1,400 lines of
HTML and script inside template literals) are replaced by a Svelte 5 app in
web/admin/. It is built on its own and embedded in the Worker as the gitignored
worker/generated/admin-bundle.ts, so no admin code ever reaches dist/, the
service worker's precache or the packaged apps. worker/routes/admin-spa.ts
serves the shell with a per-response nonce CSP after the existing Access checks,
serves hashed assets immutably, and 404s any other path under /admin.

Queue
- Rows that are decided (approved, committed, rejected) or whose game is already
  published have no checkbox, show a lock and are skipped by select-all. The
  rules come from shared/queue-rules.ts, the same module the Worker enforces.
- Decisions confirm every row first and report skipped rows with their reasons.
- Tabs with counts, cross-status search, sort, page size, all kept in the URL.
- Keyboard: j/k, x, a, r, d, e, /, Esc, ?. Ignored while typing or composing.
- Details dialog: payload, durable decision, other rows for the game, Reopen for
  a rejected row with the reason when it cannot be reopened.
- Phone layout as cards.

Edit
- One game: every change reviewed in a diff dialog before the commit; retire;
  delete a settled override file; unsaved-change guard.
- Several games: any field, set or retire, selection kept across pages and
  genres (up to 10), each game shown in the review.

Jobs, Audit and Health get their own paged, filterable pages. Health draws its
table on a 503 too, and Test write proves the write path.

An expired Access session reloads the page once; a refusal that survives the
reload is reported instead of looping. A non-JSON response is a server error,
never "session expired".

Local development: npm run dev:admin runs the real handlers against an in-memory
D1 with demo data, and npm run preview:admin serves the built bundle through the
real serveAdmin with the production CSP. Nothing in worker/ or admin/src imports
the mock, and the Worker has no authentication switch.

Also: design tokens move to src/styles/theme.css, shared by both builds;
verify-dist fails if admin code reaches dist/; vite-plugin-pwa is declared, as
src/app.d.ts references its types; docs/ADMIN.md, DEPLOYMENT.md and CLAUDE.md
describe the new admin.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 22:46:33 +07:00
poli0981andClaude Opus 5 1b6ad7be47 feat(admin): read-only decided and published rows, reopen, reconcile sweep, retention
The server half of the admin rework. The pages still run on it unchanged -
every change here is additive - until the new UI replaces them.

Read-only rows. web/shared/queue-rules.ts holds the queue's rules once, for the
Worker and the UI: a row is locked when it is approved (its request is already
committed to Git), committed (the game was observed in data/) or rejected, and
also when its GAME is already published, since one appid can have several
rows. /api/admin/decide refuses locked rows when it reads them and again in
every UPDATE's WHERE, and reports each refused id with a reason - not-found,
not-decidable, published, open-row-exists, duplicate-in-request, no-op,
changed-concurrently. It used to drop them silently, so a mixed selection
reported fewer decisions than it was sent. The queue listing carries
`published` per row, and status=all searches every tab when there is a query.

Bugs fixed on the way:
- Requeueing or deferring a failed row while another row for the appid was
  open broke uq_queue_open_appid inside the batch: a 500 for the whole request.
  It is now a skip.
- When an approval's commit landed and the queue update failed, the job's
  status was in the same rolled-back batch and stayed 'pending' forever, and
  the message promised reconcile would promote rows it never reads. The job is
  recorded first, and the message says what is actually true.
- The health endpoint returned 503 without a body the page could render.

New: POST /api/admin/reopen returns one rejected row to pending and deletes
only its 'rejected' decision, in one transaction whose guards refuse a
published game or an appid with another open row - replacing a raw-SQL step in
the runbook. Jobs and audit page with totals and filters. Approval reasons are
recorded in the audit row and the commit body.

Reconcile sweeps pending, deferred and failed rows whose game is already in
data/ to committed (a game published after its approval aged out stayed
'failed' forever), holds a cross-isolate D1 lease, and skips the ~6 MB dataset
fetch while index.json's generation is unchanged. Migration 0002 adds the two
tables; lib/locks.ts treats a missing table as unavailable, so the Worker and
the migration can ship in either order.

Overrides: the Worker can now delete a SETTLED override file - no active field,
every retirement already restored - through createCommitOnBranch deletions,
and every override commit writes a commit_jobs row.

audit_log and commit_jobs are pruned daily after ADMIN_RETENTION_DAYS (180),
which the privacy policy now states.

Tests: the real handlers against the real migrations on node:sqlite
(worker/testing/sqlite-d1.ts), with GitHub and the dataset faked - 57 new
cases across decide, reopen, reconcile, leases, retention, override deletion
and the createCommitOnBranch payload.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 22:03:39 +07:00
poli0981andClaude Opus 5 75c5fcb8ab feat(desktop): a working auto-updater, and updates that no longer reset the app
The updater plugin, its signing key and its capability shipped with 2.0.0,
but nothing called check(), and its endpoint could not have worked anyway:
releases/latest/download/latest.json follows GitHub's single "latest" release,
and this repository publishes dataset, Android and desktop releases on one page.

- The feed is now /api/updates/desktop. The Worker reads releases.atom (no
  anonymous-API rate limit, never lists drafts), takes the highest
  desktop-vX.Y.Z, and serves its latest.json only if the version matches the
  tag and every artefact URL is this repository's own release download.
  Anything unusable is a 204, the updater's "no update". Public, edge-cached,
  and - like /api/activity - never touches the GitHub App token.
- The app checks five seconds after launch, once per session and only after
  consent, and offers the update in a dialog: plain-text release notes,
  download progress, then relaunch through tauri-plugin-process. The npm
  plugins match their Rust crates' minor versions, which the Tauri CLI
  requires.

That exposed a second bug. purge_stale_webview_data cleared the webview's
storage whenever the stamped version differed from the running one - so every
update would have wiped consent, theme, language and the cached catalogue.
Only builds before 2.0.0 ever registered a service worker, so needs_purge()
now clears only for a missing or pre-2.0 stamp, with unit tests.

Release plumbing: both release workflows use a plain `npm ci` (web-ci.yml
already forbade the `|| npm install` fallback that once hid a broken
lockfile), their notes stop describing a fixed 1400x900 window, GitHub Pages and
raw.githubusercontent, and web-ci builds and verifies the Tauri configuration
on every change. The privacy policy states what each app's update check
contacts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:53:22 +07:00
poli0981andClaude Opus 5 4e7ebfe631 feat(web): an installable web app - registration, update prompt, install, offline toasts
The 2.0.0 web build generated sw.js and manifest.webmanifest and used
neither: @vite-pwa/sveltekit injects its registration into index.html, and a
SvelteKit build has none, so no page ever registered the worker or linked the
manifest. Only browsers still running the React-era worker had one, and the
site could never be installed.

- lib/pwa-state.svelte.ts registers the worker once consent is given, and
  listens from mount for beforeinstallprompt (it fires once, early),
  appinstalled, display-mode and connectivity.
- registerType "prompt": a new version waits, and PwaIndicator offers Reload
  in a toast instead of the page reloading itself mid-read. Workers already in
  the field install the new one as waiting, which activates normally.
- The root layout links the manifest; the topbar and Settings offer
  installation when the browser allows it.
- The ten pwa.* strings that had sat unused since the port are in use.
- The Tauri build omits the plugin, so its virtual modules resolve to no-op
  stubs there, and verify-dist.mjs fails a Tauri build that links a manifest.

Checked in a browser: the worker registers and precaches after consent, a
rebuilt worker waits and raises the update toast, and Reload activates it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:47:52 +07:00
poli0981andClaude Opus 5 416990e7e2 feat(web): prerender a page per game, from build-time seeds
/games/<appid> was client-rendered only, so the 3,650 pages that describe the
actual catalogue were invisible to search. On the web build each one is now a
real document with its own title, description, social image, JSON-LD
VideoGame record and sitemap entry. The Tauri build prerenders none.

Two constraints shaped how:

- A crawler never accepts the terms, so it never loads the catalogue. The page
  must render from data baked in at build time. build/game-seeds.ts reads
  ../data once in the SSR build and inlines a seed per game - slow-changing
  fields only. Players, peak, reviews and metacritic are never baked: data
  commits do not rebuild the site, so they always come from /api/data/*.

- It is a UNIVERSAL load, not a server load. With +page.server.ts every client
  navigation fetches /games/<appid>/__data.json, and for a game added after the
  deploy that is index.html at 200 - parsing fails and the page errors. The
  browser half of the load reads the same seed back out of the page's
  #game-seed block, so hydration matches, and returns null after a client-side
  navigation, where the live catalogue renders.

fallback-route.ts previously re-rendered /games/* on every cold load, which a
prerendered page must not get. Pages that may arrive as the dashboard shell now
announce themselves with markRouteRendered(); recovery runs only when that did
not happen (new games, Tauri, studio pages). A page for a game removed since the
deploy shows "Game not found" with noindex once the catalogue loads, with the
removal reason when there is one.

Measured: 3,649 pages, build 16 s -> 30 s, dist 143 MB, ~38 KB a page. The
service-worker precache ignores them, the crawler ignores 404s for Worker-only
/img/ and /api/ paths and nothing else, and verify-dist.mjs --web checks every
game page carries its seed and JSON-LD and that no __data.json exists.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:43:14 +07:00
poli0981andClaude Opus 5 c8f17d8efa feat(web): verified shard generations, offline fallback, and revalidation
The screenshots showed "3,666 games · 2026-09-12" on 09-17, while the site
served 3,649 / 09-17. Three client-side paths could produce that, and each is
closed:

1. A tab loaded the catalogue once and never looked again. The layout now
   revalidates on visibility, focus and online (at most once a minute) and
   every ten minutes while visible: one ~600-byte index request, shards only
   when the generation changed. Resource.data is $state.raw, and a check that
   finds nothing new returns the same object, so pages do not re-render.

2. The service worker answered /api/data/* NetworkFirst with a 5 s timeout, so
   a slow index came back from its cache and was taken as current. That route
   is gone; lib/pwa.ts deletes the leftover f2p-data-v3 cache. IndexedDB is the
   only offline copy, and the loader now falls back to it when the index
   cannot be fetched - which also gives the packaged apps, which have no
   service worker, the offline mode their comments already claimed.

3. index.json and the shards are cached independently on the way to the
   client, so a new index could arrive with an old shard and be cached as a
   pair under the new stamp. Shards are now requested by the sha256 their
   index entry records. The Worker serves such a request only if the bytes
   hash to it - then caches it for a year, since content addressed by its own
   hash cannot go stale - and otherwise answers 503 (remembered for 20 s, so a
   wave of retries does not re-pull 1.2 MB each from GitHub, whose CDN does not
   honour a query string). The client verifies again, caches only a fully
   verified generation, keeps showing the one it holds meanwhile, and retries
   with backoff. An index without hashes loads exactly as before.

games-loader.ts is the whole policy as a pure function, with a test for every
branch; data.test.ts covers the Worker side. The topbar says when data is an
offline copy or when newer data is waiting upstream.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:32:39 +07:00
poli0981andClaude Opus 5 146f8ad3e8 feat(data): per-shard sha256 in index.json, and last_updated only when data changed
index.json was the client's only freshness signal and it was stamped on every
save. Two failures followed from that:

- A run that changed nothing still produced a new last_updated, so every
  visitor re-downloaded all ~6 MB of shards (the 2026-09-16 "Dead link check"
  commit touched only index.json).
- Nothing tied an index to the shard bytes it describes. index.json is edge-
  cached for 30 s and the shards for 300 s, on top of raw.githubusercontent's
  own CDN, so a client could receive the NEW index with an OLD shard and store
  that pair in IndexedDB under the new stamp, where it stayed until the next
  change.

_save_index() now records the sha256 of each shard's exact bytes and keeps the
previous last_updated when files, counts and hashes are unchanged - leaving
index.json byte-identical, so such a run makes no commit. save_jsonl writes LF
explicitly: on Windows, text mode wrote CRLF, which is not the blob Git stores
or raw.githubusercontent serves, and the hash would have described bytes no
client receives. An index without hashes bumps exactly once.

The pipeline had no tests. scripts/tests/test_index_hash.py pins all of this,
python-tests.yml runs it, and notify-ci-failure now also watches Web CI,
Python Tests, Daily Snapshot and Top Offline, which it silently did not.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:27:06 +07:00
poli0981andClaude Opus 5 98fae88fd0 docs(claude): the chart-colour, keyed-each, pending and i18n rules P1 established
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:25:07 +07:00
poli0981andClaude Opus 5 6d1663f070 fix(web): real 404s, legacy hash links, and the packaged apps' Steam links
- An unknown URL rendered the dashboard. Both hosts answer a miss with the
  prerendered index.html at HTTP 200; the router knows no route matched
  (page.route.id is null), so the layout now renders the 404 view in place,
  noindex. It deliberately does not goto(): navigating to an unmatched URL
  falls back to a native load, which the host answers with index.html again,
  forever.
- /#/games/730 links from 1.4.x builds changed the address bar and left the
  dashboard on screen: the rewrite ran after the router had rendered. It is a
  replacing goto now.
- In the desktop and Android apps the table's Steam icon dead-clicked
  (window.open is blocked, and the link interceptor only sees <a>), and the
  steam:// button was refused by tauri-plugin-shell's default scope, which
  allows only mailto/tel/http(s). tauri.conf.json widens `plugins.shell.open`.
- A worker error left every queued shard parse unsettled, so the catalogue
  hung on "Loading..."; those shards are now parsed on the main thread.
- The mobile menu is a bits-ui Dialog: focus trap, Escape, focus return.
- hooks.client.ts finally calls the stale-chunk reload that chunk-error.ts has
  carried, uncalled, since the port.
- The /stats diagonal reference line never drew: markLine was used and
  MarkLineComponent was never registered. charts.test.ts now fails on any
  option key whose component is missing.
- About's labels follow a language switch.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:24:40 +07:00
poli0981andClaude Opus 5 c8daa927ea fix(web): palette crash on open, and prerendered pages that lied
Ctrl-K threw the moment it opened. /charts/anti-cheat/list was listed in both
CHART_PAGES and EXTRA, the palette renders routes in a keyed each, and a
duplicate key throws in a Svelte 5 production build. paletteRoutes() now
deduplicates and nav.test.ts holds the lists unique. The palette also gained
the arrow-key and Enter navigation its footer has always advertised, and the
shortcut hint says ⌘K on Apple keyboards.

Every prerendered page was wrong in ways only the built HTML shows:

- The consent dialog was in all of them. The gate rendered whenever
  `accepted` was false, which it always is before storage is read, so
  returning visitors saw it flash on every full load. It now waits for
  consent.hydrated.
- It also covered /legal/*, the documents it asks people to accept, which
  therefore could not be read before accepting them.
- `loading && !data` is false before a load starts, so /games shipped "No game
  matches these filters.", /health "Nothing flagged" and the chart pages
  "None". Resource.pending (no data, no error) replaces all 15 checks.
- Meta descriptions interpolated counts that are zero at build time ("Overview
  of 0 F2P Steam games"); they are static now, and the headers show counts
  only once data exists.

scripts/verify-dist.mjs reads dist/ in CI and fails on each of these. The
sidebar's "Manage" group is "Project" - nothing in a read-only app is managed -
and /publishers finally has a sidebar entry.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:19:01 +07:00
poli0981andClaude Opus 5 5397d3b895 fix(web): unfilled i18n placeholders, and chart colours zrender cannot parse
The three screenshots of the live site traced to two bugs, each wider than
the page it was noticed on.

Placeholders. t() leaves {{var}} in place when a variable is missing, and
seven call sites never passed one: "Languages ({{count}})", the peak suffix
"(peak {{peak}})" rendered as a FIELD LABEL through `detail.${f.key}`, the
same suffix as the /stats scatter axis and tooltip, the Steam-icon tooltip on
every /games row, and the prerendered meta description of the anti-cheat
index. i18n.test.ts only proved keys exist; it now reads every call site and
fails on a missing variable, on a placeholder key stored in a lookup table, on
a template-literal key, and on any key-shaped literal that does not resolve.
The four remaining dynamic keys became literal tables.

Colours. chartTheme() emitted space-separated hsl(38 94% 60%). The canvas
paints that, but zrender's own parser splits on commas, so every hover state
derived from it came back undefined and the hovered tile, bar or slice lost
its fill - the blank "Card Game" treemap tile was simply the one under the
cursor. Five pages also passed hsl(var(--x)), which a canvas never paints.
Tokens are converted to the comma form, the semantic tones joined ChartTheme,
and a test runs zrender's real parser over every token in both themes.

Also: the treemap tooltip used the pie-only {d}; every grid used containLabel,
which in echarts 6 ignores axis names (both /stats axis titles were clipped);
option colours now follow a theme switch; review tones follow Steam's bands;
the game page shows Steam's wording beside the score, links its studios, and
says "Game not found"; studio pages no longer decode params twice (URIError on
"90% Studios"); duplicated studio names no longer crash the keyed each.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 21:14:28 +07:00
github-actions[bot] 0161bfdaec Update reviews [2026-09-17] 2026-09-17 13:01:58 +00:00
github-actions[bot] c3136d796a chore(data): mark dead games 2026-09-17 09:34:47 +00:00
github-actions[bot] ed6d196346 Auto update [2026-09-17] 2026-09-17 03:02:20 +00:00
github-actions[bot] 2e98e368b3 Snapshot [2026-09-17] 2026-09-17 01:13:01 +00:00
github-actions[bot] c07a72a2b0 Dead link check [2026-09-16] 2026-09-16 11:01:37 +00:00
github-actions[bot] 3ca1cf8bd6 Top online [2026-09-16 08:40] 2026-09-16 08:40:04 +00:00
github-actions[bot] 87ccb46984 Auto update [2026-09-16] 2026-09-16 02:59:12 +00:00
github-actions[bot] 212afb9b51 Snapshot [2026-09-16] 2026-09-16 01:11:28 +00:00
github-actions[bot] 52cdf40a5e Update reviews [2026-09-15] 2026-09-15 13:08:05 +00:00
github-actions[bot] 34291c5a6d Top offline [2026-09-15 10:26] 2026-09-15 10:26:00 +00:00
github-actions[bot] e7b7d4bc26 Auto update [2026-09-15] 2026-09-15 03:02:41 +00:00
github-actions[bot] b7c6d3b3eb Snapshot [2026-09-15] 2026-09-15 01:17:03 +00:00
github-actions[bot] 5e1305f1d3 Purge unhealthy [2026-09-14] 2026-09-14 12:14:16 +00:00
github-actions[bot] 5faef12724 chore(data): mark dead games 2026-09-14 10:01:40 +00:00
github-actions[bot] 1a778e4def Auto update [2026-09-14] 2026-09-14 03:00:24 +00:00
github-actions[bot] 85a0960fd4 Snapshot [2026-09-14] 2026-09-14 00:50:54 +00:00
github-actions[bot] 8fcf6411e5 Update reviews [2026-09-13] 2026-09-13 13:09:46 +00:00
github-actions[bot] f76784aae7 Top online [2026-09-13 08:23] 2026-09-13 08:23:02 +00:00
github-actions[bot] 76737f572d Auto update [2026-09-13] 2026-09-13 02:46:03 +00:00
github-actions[bot] cd26323428 Snapshot [2026-09-13] 2026-09-13 00:43:32 +00:00
poli0981andClaude Opus 5 99df399b19 ci(web): knip exits 1 on an unlisted binary, not on the export backlog
The Web CI "Unused code report" step failed on the merge. The export and type
backlog was not the cause - knip.json already marks both "warn" - it was this:

    Unlisted binaries (1)
    python  package.json

knip reads package.json's scripts and treats a binary it cannot resolve to a
package as an ERROR, which exits 1 regardless of the warn-level rules. The
`fonts` script (`python scripts/gen-fontface.py`) arrived with the SvelteKit
rewrite, so the failure arrived with it too.

python is a system tool here, not a dependency, so it is declared as ignored
rather than installed.

How this reached main: I had been running `npm run knip | grep ...` locally,
which reports the pipeline's exit status and not knip's, so a red run looked
green every time. Checked with `npm run knip > file; echo $?` now, and that is
what the verification should have been all along.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 15:09:07 +07:00
poli0981andClaude Opus 5 28e0e04c60 feat(app): 2.0.0 — and the packaged build was shipping the OLD app
Version bumps plus the Phase 7 binary work, but the reason this commit is
large is that building an actual 2.0.0 desktop binary and driving it over CDP
found three defects that no amount of reading would have.

## The desktop app was serving the React UI from a dead service worker

The 2.0.0 build launched, in its new 1280x860 window, showing the 1.4.x
React app: a sidebar reading "Steam · v1.0", no Stats or Developers entries.
Measured in the running release binary:

    caches: ["workbox-precache-v2-http://tauri.localhost/"]
    navigator.serviceWorker.controller: http://tauri.localhost/sw.js

A service worker registered at tauri.localhost can never be updated. Asking
it to, in the packaged app:

    TypeError: Failed to update a ServiceWorker for scope
    ('http://tauri.localhost/') with script ('http://tauri.localhost/sw.js'):
    An unknown error occurred when fetching the script.

The update algorithm refetches the worker script bypassing the worker itself,
and Tauri's custom protocol does not satisfy it. So the worker installed by
whatever version a user ran FIRST answers every navigation from its own
precache - index.html included - for the life of the install. Every desktop
and Android release since the PWA landed would have shipped invisible.

No frontend fix exists: the frontend that would unregister the worker is the
part being served from the stale cache. It has to happen before the webview
loads anything, so `purge_stale_webview_data` in lib.rs clears the webview's
storage once per version.

That clear also wipes localStorage and IndexedDB - WebView2's
ClearBrowsingData is all-or-nothing - so an upgrade re-asks for legal consent
and re-downloads the catalogue once. Stated in the code rather than glossed:
being asked for consent again beats silently running last year's app.

It also needs an explicit reload, because setup() runs while the first page is
already loading and clearing storage underneath it leaves an empty body. That
was found the same way - by looking at the window after the first attempt.

The build now omits the PWA plugin entirely when TAURI_ENV_PLATFORM is set.
The packaged apps lose nothing by it: their assets are local files already,
and offline data has always come from the IndexedDB cache in lib/cache.ts.

## The CSP would have bricked both packaged apps

`kit.csp` ships inside the Tauri bundle, and there the page origin is
tauri://localhost - so `connect-src 'self'` means the BUNDLE, not the site.
Every /api/data/* fetch would have been blocked and the apps would have shown
an empty catalogue. Separately, Tauri sends its own CSP as a header, and a
browser enforces the INTERSECTION: its `script-src 'self'` would have won
against SvelteKit's hashed meta policy and blocked the hydration bootstrap -
the same failure the web build hit before the CSP moved.

svelte.config.js now emits a second flavour when TAURI_ENV_PLATFORM is set,
naming the site origin explicitly. The web policy is untouched and still has
no api.github.com in connect-src - removing it was deliberate, /api/activity
proxies it - so the looser sources exist only where they are needed.

Verified in the running binary: consent accepted, 3,666 games loaded
cross-origin, a chart painted, both fonts reporting "loaded". And
/games/730 opened by full page load resolves to Counter-Strike 2, which
finally proves at runtime what CLAUDE.md had only asserted about
tauri::manager::get_asset()'s fallback chain.

## Binary 2.0.0

- The window unlocks: 1280x860, resizable, maximisable, minimum 880x600. It
  was pinned to exactly 1400x900 with minWidth == maxWidth, which made a
  responsive redesign pointless on the one platform that could not use it.
- tauri-plugin-http is gone, with its `https://github.com/*` capability and
  its plugin init. It existed for the GitHub OAuth Device Flow, whose
  endpoints send no CORS headers; sign-in was removed, and the only remaining
  GitHub call is android-update.ts, a plain fetch to an endpoint that does
  send them.

## Docs

web/README.md described React 18, Zustand, TanStack Query, HashRouter, a
GitHub Pages deploy, fetching from raw.githubusercontent.com, PAT sign-in and
client-side GPG signing - and a directory tree in which almost no path still
exists. Rewritten against the code.

The CHANGELOG's v4.0.0 entry says 95 tests because that is what `vitest run`
prints.

check / 95 tests / build / knip / wrangler dry-run clean. Desktop release
binary built, launched, and driven.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 15:05:16 +07:00
poli0981andClaude Opus 5 bc39a3162c fix(web): every deep route was serving the dashboard, and no page had a social card
Found by walking the built site in a browser rather than by reading it. Four
defects, none of which produced an error, a warning, or a failing build.

## /games/730 rendered the dashboard. So did every studio page.

The three routes that are deliberately not prerendered - /games/[appid],
/developers/[name], /publishers/[name] - have to be answered with an app
shell on a cold load. Both hosts answer with `index.html` SPECIFICALLY, and
neither can be told otherwise: Cloudflare's
`not_found_handling: "single-page-application"` names no file, and Tauri's
get_asset() chain is compiled in. index.html is the PRERENDERED DASHBOARD,
and a prerendered page embeds its own hydration payload - `node_ids: [0, 2]`.
SvelteKit hydrates exactly those.

The router was not confused: page.route.id was "/games/[appid]" and page.url
was right, so the canonical tag and og:url were correct. Only the rendered
components were the dashboard's. HTTP 200, clean console, correct metadata,
wrong page - the single visible symptom was the <h1>.

Two things had to change:

- `paths.relative` off. SvelteKit defaults it on, which gives PRERENDERED
  pages "./_app/..." asset URLs. Served as the fallback for /games/730 those
  resolve to /games/_app/..., which 404s back into the SPA handler and
  returns index.html as text/html. The browser refuses it ("Expected a
  JavaScript-or-Wasm module script..."), so the page did not hydrate at all.
  Invisible until a route actually fell through, because 200.html was always
  absolute.
- fallback-route.ts re-navigates on first mount when the route is one of the
  three. Those routes are never prerendered, so a document delivered for one
  is always the substituted shell - there is no legitimate case to fight.

`_redirects` was tried first and does not work: Workers Static Assets has no
200-status rewrite, and `/games/* /200.html 200` is honoured as a REDIRECT -
the address bar became /200 and the app 404ed. Measured, not assumed, and
recorded in the module so it is not tried again.

## No page had an Open Graph tag

Every route hand-wrote <title> and <meta description> and nothing else, so a
link shared to X, Discord, Slack or iMessage rendered as a bare grey URL, and
nothing but /games/[appid] had a canonical. One <Seo> component now owns the
head for all 30 routes: OG, Twitter, canonical, optional JSON-LD, and the
site name that had been spelled out in 20 files.

og:image is absolute from a constant, not from page.url.origin - during
prerender that is SvelteKit's internal "http://sveltekit-prerender" host,
which would have been baked into every static page.

ChartPage's `subtitle` becomes required. It was optional, which is what let a
chart page ship with no description and look entirely normal.

## The social card and icons did not work at all

og:image pointed at an SVG - X, Facebook, LinkedIn, Slack and Discord all
refuse SVG previews - and the PWA manifest offered SVG icons only, which
Android's installer and apple-touch-icon do not accept. The old mark drew a
"▶" as an SVG <text> element in font-family="system-ui", i.e. a different
shape on every platform and tofu where no font had the glyph, in the slate
palette the rewrite replaced.

static/icon.svg is now the single source of the mark as real geometry, and
scripts/gen-icons.py derives the PNG icons and a 1200x630 card from it, set
in the actual brand typefaces. theme-color was still slate #0f172a; it is now
two entries, because one value can only ever be right for half the users of
an app with a real light mode.

## sitemap.xml listed four URLs, three of them github.com

And not one of the app's own routes. It is now a prerendered endpoint driven
by import.meta.glob over the route table, so adding a page adds a sitemap
entry with no second list to remember: 33 URLs, all on-site.

## Also

- Both remaining ECharts [Violation] warnings, measured before and after.
  "setTimeout took 122ms" is gone: zero long tasks while four charts init,
  because IntersectionObserver moved each init out of the shared frame. The
  non-passive mousewheel one needed a real fix - zrender binds BOTH `wheel`
  and `mousewheel` with no options object, unconditionally, with no dataZoom
  anywhere. Four blocking listeners for two charts, measured. EChart.svelte
  now swaps addEventListener for exactly the duration of init(). That is
  scroll jank, not just console noise: the charts sit inside the page's
  scroll container. charts.test.ts asserts no chart uses dataZoom or roam,
  since a passive listener cannot preventDefault.
- errors.403 told visitors to "check your token in Settings" and errors.419
  was titled "Session expired". Sign-in was removed; there is no token and no
  session. 419 is dropped from ERROR_CODES because nothing can produce it,
  along with three keys nothing referenced.
- og.png is excluded from the precache. @vite-pwa/sveltekit adds every static
  asset regardless of globPatterns, so 145 KB that only crawlers ever fetch
  was going into every install.

49 new tests, each one mutation-checked: relative og:image, a route with no
head, and a missing entry in the not-prerendered list were each confirmed to
fail the suite before being restored.

check / 95 tests / build / knip / wrangler dry-run clean. Eleven routes walked
in a real browser with zero console messages.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 14:45:05 +07:00
poli0981andClaude Opus 5 85f1a97f39 fix(web): CSP that lets the app hydrate, the PWA, and two unported modules
Four regressions the port had introduced, all found by looking at the running
app and at knip rather than by assuming the migration was complete.

## The app did not hydrate at all

SvelteKit emits exactly one inline <script> per page - the hydration bootstrap
- and offers no way to avoid it. Under _headers' `script-src 'self'` the
browser blocked it, so every page rendered its prerendered HTML and then sat
there completely inert. Measured in a real browser, on every route:

  Executing inline script violates ... directive 'script-src 'self''

The CSP now lives in svelte.config.js under kit.csp with mode "hash", so
SvelteKit computes that script's sha256 at build time and emits the whole
policy as a <meta> tag that already trusts it.

The header CSP had to GO, not relax: browsers enforce the INTERSECTION of a
header policy and a meta policy, so leaving `script-src 'self'` in _headers
would have kept blocking the script whatever the meta allowed. One directive
is lost in the move - `frame-ancestors` is ignored in a meta CSP - so
X-Frame-Options: DENY in _headers is now load-bearing rather than
belt-and-braces.

Verified after: hydration confirmed by 26 virtualised rows existing (they only
exist if the client ran), both fonts reporting "loaded", and a fresh tab
walking /about and /charts/genres with ZERO console messages. The font
"preloaded but not used" warnings were a symptom of the same thing and are
gone with it.

## The PWA was simply missing

@vite-pwa/sveltekit was installed and never configured, so the build emitted no
service worker at all - no offline support and no update flow, both of which
the React app had. Configured with the runtime caching carried over verbatim,
including the reasons: NetworkFirst for /api/data/* because index.json carries
last_updated and serving THAT from cache strands every reader on stale records,
and the navigateFallbackDenylist because an installed SW answering /admin from
the app shell would serve the public shell where the Access gate is expected.

## Two modules ported but never wired up

- external-link-interceptor: the Tauri webview blocks window.open() and
  target="_blank" to external http(s), so without it every external <a> in the
  packaged builds dead-clicks.
- android-update: Android has no native Tauri updater (the plugin is
  desktop-only), so the APK checks GitHub Releases itself. Both packaged apps
  had silently lost a feature.

## knip was blind to the whole UI

Its project globs were still {ts,tsx} from the React era, so after the
migration it could not see a single .svelte file and reported the entire UI
dependency tree as unused. Fixing that is what surfaced the three items above,
plus two primitives I wrote and never used. No unused files or dependencies
remain.

CLAUDE.md updated: six of its notes described a React app that no longer
exists, which is worse than no note - an agent reading it would go looking for
files that are gone. It now records the four traps this change cost:
the CSP-must-not-be-in-two-places rule, adapter-static's fallback overwriting
index.html, nothing gating markup behind onMount, and $state being required for
a value an $effect must react to.

check / test / build / knip clean. 46 tests.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 14:04:33 +07:00
poli0981andClaude Opus 5 939e3431b4 feat(web): every remaining route, and prerendering that actually works
All 30 routes now serve: the eleven chart pages, both leaderboards, health,
activity, about, settings, donate, the four new surfaces (/stats, /developers,
/publishers, /games/[appid]) and the in-app /legal/[doc] viewer. Verified
through a real `wrangler dev` - all 30 return 200, and security.txt, robots.txt
and sitemap.xml still serve as static files.

## /legal/* exists, and no markdown code ships

This settles the sanitizer question the plan left open: the answer is that
none of it reaches the browser. +page.server.ts runs ONLY on the server -
here, at build time, because the route is prerendered - so unified/remark/
rehype live in the build and the HTML is baked into the page. Verified the
client bundle contains no markdown library at all. No {@html} of anything
unparsed, no CSP change, nothing to reason about at runtime.

rehype-sanitize is still applied. It costs nothing at build time and the
alternative is a build that silently starts emitting whatever a future
contributor puts in a legal document.

Relative links inside the documents are rewritten: `docs/ToS.md` becomes
/legal/tos where a route exists, everything else goes to GitHub. Without that
the prerenderer follows them and the build dies on `404 /SECURITY.md` - which
it did.

## Two prerendering bugs, both found by reading the output

**Every page shipped an empty body.** The layout gated its markup behind
`{#if ready}`, set from onMount - which does not run during prerender. So the
entire SEO purpose of the migration was defeated: dist/legal/tos.html had 296
bytes of comments, no <h1>, no article text. Removing the gate is safe because
`en` is statically bundled as the i18n fallback, so t() returns real strings
from the first render.

Consequence of that: the consent gate had to stop being a replacement for the
page. It returned children-or-gate, so every prerendered page's HTML would
have been the consent dialog rather than its content. It is an overlay now -
crawlers see the real page, visitors still cannot use the site until they
accept. Measured after: /legal/tos 5,457 chars of text, /about 3,663.

**The home page was overwritten by the SPA fallback.** adapter-static writes
the prerendered pages and then writes the fallback over whatever shares its
name, so `fallback: "index.html"` replaced the prerendered `/` with an empty
shell - the most important page on the site, at 3,403 bytes of comments.
Renamed to 200.html; index.html is now the real dashboard at 45 KB.

## Other things fixed while porting

- The anti-cheat pattern table was duplicated between the list page and the
  chart. Extracted to lib/anti-cheat.ts, which also keeps is_kernel_ac's THIRD
  state: null means nobody checked, and folding it into "user-mode" would
  claim something the data does not say. It is its own bar.
- The tag cloud draws 60 words, not 100, and picks colours deterministically.
  The React version called Math.random() per word on every render, so the same
  tag changed colour on each repaint and the palette meant nothing - and
  wordcloud layout was the biggest contributor to the reported 122ms
  setTimeout violation.
- Charts use meaning-bearing tokens (--success/--warning/--destructive) where
  a colour carries information, and the accent ramp only for decoration.
- The About page's dependency list was wrong in six places and credited
  OpenPGP.js, which is not a dependency at all. It now lists what actually
  ships, typefaces included.
- Every leaderboard says "Top 100" and now shows 100; it was showing 40.

The i18n test earned its place twice more: it caught `donate.intro`/`outro`
and `health.allClear`, none of which existed. 457 keys, en and vi in sync.

Left deliberately undone, with the reasoning in the code: /games/[appid] is
NOT prerendered. Doing it needs a build-mode split (3,600 HTML files would
bloat the APK) and only the slow-changing fields could be baked in, since
daily data commits do not trigger a rebuild.

check / test / build clean. 46 tests.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 13:55:23 +07:00
poli0981andClaude Opus 5 8ed868f00c feat(web): games table, and a test for missing i18n keys
The catalogue's main surface: virtualised table above md, virtualised cards
below it, Fuse search, five facet filters, sortable columns, paging, CSV/JSON
export. Verified against real data at 1440x900 - 3,666 rows, 37 pages.

Column labels are i18n KEYS now. All twelve were hardcoded English inside an
app whose every other visible string was translated, so a Vietnamese reader got
a Vietnamese page wrapped around an English table header.

Sorting parses before comparing, which is not optional here: current_players is
"492,197" and reviews is "86% (Very Positive)", so a raw compare puts "9" above
"1,000,000" and orders reviews alphabetically. Unrated sorts to -1 so "N/A"
clusters at one end instead of interleaving. Release dates go through
parseReleaseDate because "22 Aug, 2012" string-compares by day-of-month.

Third click on a sorted column CLEARS the sort rather than cycling back to
ascending - there was otherwise no way back to the natural order.

## One bug, found by looking at the DOM

Rows rendered blank while the scrollbar was the right height. `getTotalSize()`
was correct and `getVirtualItems()` returned nothing: `getScrollElement` is a
closure, so referencing `viewport` only inside it registers no dependency, and
the virtualizer was built once before `bind:this` had run, measured a null
scroll element and never rebuilt. `$derived.by` that READS `viewport` in its
body fixes it. Same fix in both the table and the mobile cards; the comment
names the symptom, because "correct scrollbar, no rows" does not look like a
reactivity problem.

## The i18n test

Two raw `{{n}}` placeholders reached the screen while building this page:
common.rowsPerPage is "{{n}}/page" and common.page is "{{current}}/{{total}}" -
whole phrases with numbers inside, not standalone labels. And the React table
called t("edit.openOnSteam") where `edit` was not a namespace at all, so that
tooltip rendered the literal key in production with nothing to flag it.

src/lib/i18n.test.ts now scans every .svelte and .ts file for literal t("...")
calls and asserts each key resolves to a string in en.json, that en and vi have
identical key sets, and that a key's placeholder set matches across locales.
Mutation-checked by injecting t("edit.openOnSteam") - the exact key that
shipped broken - which turns it red.

46 tests, up from 39. Locales at 430 keys each, still in sync.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 13:34:07 +07:00
poli0981andClaude Opus 5 369cc776d0 feat(web): app shell, data layer and first pages on SvelteKit
The shell runs end to end against real data: consent gate, sidebar, topbar,
command palette, theme switching, i18n, the catalogue load, and a rendering
ECharts chart. Verified in a browser at 1440x900 and at mobile width.

## Data layer, without TanStack Query

lib/resource.svelte.ts is ~90 lines of runes replacing @tanstack/react-query.
What the app used from that library was isLoading/error/data/refetch, a stale
time and one refetchOnWindowFocus. Caching is deliberately NOT reimplemented:
the catalogue's real cache is IndexedDB keyed on index.json.last_updated, the
only invalidation signal this dataset has, and a memory cache on top would be a
second thing to get wrong. The three-step load (read cache, compare
last_updated, else fetch shards and parse in a worker) is carried over exactly.

## i18n gaps closed rather than carried forward

The plan listed eleven categories of hardcoded English inside an otherwise
translated app. Fixed so far:

- The seven KPI labels, which lived as string literals in KpiCards.tsx.
- formatRelativeDate, which returned "today" / "3d ago" / "2w ago" regardless
  of locale. Now Intl.RelativeTimeFormat, which also handles pluralisation -
  the part a template string per language cannot do.
- formatNumber, which hardcoded toLocaleString("en-US"), so a Vietnamese
  reader saw 1,234,567 where their locale groups as 1.234.567.
- The command palette, whose 17 labels were the only untranslated strings in
  the app. It is now built from the nav lists instead of its own array - which
  had already drifted, missing /top-offline, /donate,
  /charts/anti-cheat/list, /charts/delisted and /welcome.

en.json and vi.json go 353 -> 392 keys, edited together by script with the leaf
sets asserted equal, because hand-editing one is how they stop matching.

## Things fixed on the way through

- Ctrl-K now checks e.isComposing. Without it the shortcut fires mid-IME
  composition and steals the keystroke, which made the palette actively
  hostile to Vietnamese input - the locale it exists for.
- The theme "system" option now listens for prefers-color-scheme changes. The
  React Topbar read matchMedia once and never subscribed, so "system" never
  actually reacted.
- The Toaster took the resolved theme instead of a hardcoded "dark", which had
  put a dark toast on a white page in light mode.
- The sidebar version is derived from __APP_VERSION__; it said "Steam · v1.0"
  while package.json was 1.4.5.
- Distinct icons per nav row: Trophy was used for BOTH leaderboards and Shield
  for two anti-cheat entries, which makes an icon useless for finding a row.
- legal.ts said "The 5 binding documents"; the licence split made it six.
- /legal/<slug> links are real links now. Welcome.tsx built that exact href
  and then called preventDefault() to bounce to /about, because nothing was
  there to receive it.

## Two bugs found by looking, not by guessing

**The chart rendered nothing.** ECharts initialised and created its container
but painted no canvas - which looks exactly like the unregistered-theme
failure CLAUDE.md warns about. It was not that: `chart` was a plain `let`, so
the setOption effect ran once while it was still undefined and never re-ran
when init assigned it. Making it $state fixed it, and the comment now names
both failure modes so the next person does not misdiagnose it the same way.

**Cloudflare Hotlink Protection is ON and the packaged apps survive it by
luck.** Every /img/* request from the dev server came back 403, body
`error code: 1011`. Measured against the live zone: no Referer 200, own-origin
Referer 200, but `http://localhost:5173/` 403, `tauri://localhost/` 403 and
`http://tauri.localhost/` 403 - the two origins the desktop and Android builds
actually load images from. They render today only because the Tauri webview
sends no Referer for <img>, which is not a guarantee anyone made: a WebView
update doing the ordinary spec-compliant thing would blank every image in both
apps with no change on our side. Written up as SECURITY_SETUP.md section 10
with the measurements and a recommendation to turn it off - it restricts
nothing that worker/routes/img.ts's anchored PATH_RE and host allowlist do not
already restrict, and Referer is client-set anyway.

## Still to port

The games table, nine of the eleven chart pages, about/settings/health/
activity/donate, /legal/[doc], and the four new surfaces (/stats,
/developers, /publishers, /games/[appid]). The foundation they all sit on -
routing, data, i18n, theming, charts, consent - is proven working.

check / test / build all clean; the 39 Worker tests are untouched by this.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 13:17:27 +07:00
poli0981andClaude Opus 5 e4c3bd14d8 feat(web): SvelteKit scaffold, real fonts, and the palette rework
First step of the framework switch. The React UI is removed and replaced by a
building SvelteKit 2 / Svelte 5 shell; page porting follows. The React app is
in git at 290b1ad7 and is the reference for every port.

Nothing outside web/src changes: the Worker, wrangler.jsonc, the Python
pipeline and data/ are untouched, and /admin stays Worker-rendered HTML.

## The routing risk is settled, and it went the easy way

The plan named one blocker: SvelteKit has no HashRouter, and the React app used
one under isTauri() because "the Tauri webview has no server-side fallback".

That claim is out of date. tauri::manager::get_asset() resolves a miss through
<path>.html, then <path>/index.html, then index.html - read from tauri-2.11.1,
which is the exact version in Cargo.lock. So the packaged apps serve real paths
already, and adapter-static's fallback output works unmodified on Cloudflare
AND in both apps. No HashRouter, no hash shim, one build shape for two targets.
Written up in docs/plan/15-sveltekit-migration.md, including the honest caveat
that this is read from source and still needs the Phase 7 smoke test.

## Fonts exist now

index.css declared `--font-sans: Inter` and `--font-mono: JetBrains Mono` with
no @font-face, no link tag and no woff2 anywhere in the repo, so the app had
always rendered in system-ui. Three self-hosted variable faces, each with a
job: Bricolage Grotesque (display), IBM Plex Sans (body and the 3,400-row
table), JetBrains Mono (numerals).

scripts/gen-fontface.py generates src/fonts.css from Fontsource's own CSS,
keeping latin, latin-ext and vietnamese and dropping cyrillic, cyrillic-ext and
greek - 91 KB of a 308 KB payload, for scripts an en/vi app cannot render.
unicode-range values are parsed from Fontsource rather than transcribed,
because a mistyped range is a silent rendering bug on one character. Generated
rather than hand-written so a font bump cannot leave a stale range behind.

Verified in a browser: all three faces render, and the Vietnamese subset draws
"Phiêu lưu, nhập vai, chiến thuật" with full diacritics.

**Measured, not assumed:** the plan said to verify IBM Plex Sans has real
tabular figures before committing to it for the table. It does better than
that - every digit already renders at the same advance width (all ten at 24px
at font-size 40), so alignment holds with or without `tnum`. The utility is
kept because it states the requirement and protects a future face swap.

## The palette rework index.css deferred

In its own words: "The palette rework is a separate change." This is it. Off
the stock Tailwind sky-blue, which on Steam's own blue-grey surfaces is exactly
the generic look this was meant to fix; onto a warm amber accent over
warm-hued neutrals. Meaning-bearing colours (review scores, safety, anti-cheat)
deliberately do NOT follow the accent - they have to stay distinguishable.

Token format is unchanged (raw HSL channels), because two things depend on it:
@theme inline needs them bare for bg-primary/15 to resolve through color-mix(),
and lib/chart-theme.ts reads them with getComputedStyle at call time.

Also added three things index.css never had: a :focus-visible rule, a
prefers-reduced-motion block, and a skip link.

## Ported, not rewritten

lib/ is framework-agnostic and carries over as-is. The three files that were
not:

- lazy.ts -> chunk-error.ts. lazyWithRetry is gone (SvelteKit falls back to a
  full page load itself), but the DETECTION stays, with the reason spelled out:
  a deleted hashed chunk does not 404 on either host - Cloudflare's SPA
  fallback and Tauri's get_asset both answer index.html at HTTP 200 - so the
  check has to match the MIME-type message, not a status.
- chart-nav.ts - lucide-react -> @lucide/svelte.
- i18n/index.ts -> lib/i18n.svelte.ts. Replaces i18next + react-i18next +
  the language detector with ~90 lines of runes. The locale JSON is untouched
  byte for byte: converting 353 keys x 2 for Paraglide would have been 706
  chances to typo text nobody proofreads. Keeps en statically bundled (it is
  the fallback - a lazily-fetched fallback that failed would render raw keys),
  vi dynamic, the same detection order, and the _one/_other convention.

## Housekeeping

public/ -> static/ (SvelteKit's convention). Verified _headers and
.well-known/security.txt still land in dist/. tsconfig now extends the
generated config; skipLibCheck restored deliberately - src/workers has a
`reference lib="webworker"` that clashes with lib.dom, and TypeScript resolves
`cookie` to the hoisted 1.1.1 from wrangler->miniflare->youch while SvelteKit
uses its own nested 0.6.0 at runtime.

check / typecheck / test / build / wrangler --dry-run all clean.
39 tests still pass - the Worker suite is unaffected by any of this.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 13:00:05 +07:00
poli0981andClaude Opus 5 290b1ad715 feat(admin): finish the review and edit screens, and test what a browser can't
/admin had four API endpoints with no UI at all and a set of controls that
lied about what they would do. This closes both.

## Views that did not exist

/api/admin/audit, /api/admin/health and /api/admin/me had no consumer, and
/api/admin/stats returned commit_jobs counts the page fetched and discarded -
so the one table that records a commit attempt BEFORE it is made, the evidence
that a commit died mid-flight, was only readable through `wrangler d1
execute`. Added a view switcher with Queue / Commit jobs / Audit log / Health,
plus a /api/admin/jobs endpoint to back it.

## Controls that lied

- Approve and Reject stayed enabled on the approved/committed/rejected tabs,
  where DECIDABLE guards both the server-side read and every UPDATE, so the
  click always returned 409 with no hint why. Now disabled, with the bar
  saying those rows are already decided.
- Reconcile had no busy state, so a double-click fired two ~6MB runs.
- Retire (edit page) had no guard at all, and the page had no busy flag: tab
  switching, Discard, Load and the genre picker all stayed live mid-commit.
- Retiring a field with no override is a server-side no-op, and the page still
  said "Retired genre". It now says nothing was committed.
- setMode() never cleared the other mode's state, so One -> Bulk -> One left
  `dirty` populated while the counter reported bulk.sel.size - the count and
  the payload disagreed.
- loadGenres() swallowed every error into an empty list with no message, so a
  failure left both pickers empty and bulk mode silently inert.
- No beforeunload guard: an unsaved edit vanished on navigate.

## Search was a lie too

The filter box filtered the 60 loaded rows, so an appid on page 3 reported
"Nothing on this page matches that filter" - indistinguishable from "not in
the queue". Search is now server-side, with LIKE ... ESCAPE so a name
containing % or _ is matched literally. Verified against a local D1: the
escaped form matches 1 row where the unescaped form matches 2.

Also added sort (newest/oldest/players/reviews/name) as a closed set mapped to
fixed SQL, and rendered reviews_pct and current_players_num - both selected by
the API since the schema was written, with a comment saying they exist "so the
review screen can sort", and never once displayed. NULLS LAST verified in D1.
payload_json, stored verbatim on every insert and never surfaced, now has a
details dialog. MAX_DECIDE comes from the API instead of a client literal.

## The "Session expired" lie, and the third console error

Both pages treated ANY non-JSON response as an expired session. Combined with
the Worker having had no top-level try/catch, that meant every server crash
was reported to the reviewer as a login problem. They now distinguish the
cases, and use `redirect: "manual"` so an expired Access session is OBSERVED
as a redirect rather than followed to cloudflareaccess.com - which is exactly
what produced the reported

  Connecting to 'https://polished-hall-48fd.cloudflareaccess.com/cdn-cgi/...'

console error: the CSP is connect-src 'self', so the cross-origin hop from
fetch() was blocked. Re-auth is now a full-page reload, which is the only way
Access can run its login flow.

## Tests

/admin cannot be loaded locally - it is behind Access and there is no way to
mint a JWT offline - so admin-ui.test.ts asserts everything checkable without
a browser: the nonce appears in both the header and the script tag and differs
per response, the actor is escaped (a hostile actor string does not survive as
markup), and crucially the emitted inline script PARSES. That last one is not
theoretical: the page lives inside a TypeScript template literal, so a
backtick in a comment silently ends it and a literal newline inside a JS
string is a parse error tsc cannot see. Both mistakes were made while writing
this change and caught by these tests; mutation-checked afterwards by
re-introducing each.

39 tests, up from 19.

## docs/ADMIN.md

Four corrections, all places the doc described something that does not exist:
the edit-drafts table (no such table - also fixed in wrangler.jsonc), the
`f2p-discovery` service-token NAME check (impossible - Cloudflare reports the
opaque Client ID - and it contradicted the accurate account earlier in the
same file), the parity test (now real, so it says what it actually is), and
"what is not built yet", which listed only audit pruning and now lists the
Worker's inability to delete an override file, single-field bulk mode,
selection loss across pages, un-rejecting being raw SQL, and the absence of a
cross-isolate reconcile lock.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 12:37:37 +07:00
poli0981andClaude Opus 5 43623e79d2 fix(worker): harden the admin surface, and add the tests ADMIN.md claimed
docs/ADMIN.md:473 says the CLI/Worker override parity is "asserted by a parity
test". There were NO tests in this repository at all - no *.test.ts, no
test_*.py, no vitest config, no test script. That claim is now true.

## The security defects, worst first

**Negative limit disabled the SQL bound.** admin.ts x2 and edit.ts all used
`Math.min(Number(raw) || fallback, max)`. Number("-1") is -1, which is truthy,
so `|| fallback` never fired and Math.min(-1, 200) is -1 - and SQLite treats a
negative LIMIT as NO limit. `/api/admin/audit?limit=-1` returned the entire,
never-pruned audit log; `?status=pending&limit=-1` the whole queue. Replaced
with clampLimit/clampOffset, which also truncate fractions (`?limit=1.9` bound
a non-integer). Table-tested, including a mutation run confirming the old
expression fails the new tests.

**exp was optional.** `typeof claims.exp === "number" && claims.exp < now`
accepts a token with no exp, or exp as a string - and such a token then never
expired. exp is now required; nbf, if present, must be numeric.

**CSRF was one heuristic deep.** access.ts accepts the JWT from the
CF_Authorization cookie, which a browser attaches to cross-site requests too,
so the fail-open Sec-Fetch-Site sniff was the only thing between a forced
cross-site POST and a repository write. State-changing requests now accept the
JWT ONLY from the Cf-Access-Jwt-Assertion header, which browsers never attach
on their own. curl and the discovery service token send it explicitly and are
unaffected; the Sec-Fetch-Site check stays as defence in depth.

**A key rotation locked everything out for an hour.** An unknown `kid` returned
null with no refetch against a 1-hour JWKS cache, so a Cloudflare rotation
denied admin AND ingest as an opaque 404. Now refetches once on a miss, floored
at 60s so junk kids cannot make this Worker hammer Cloudflare.

**An outage looked like a bad token.** A failed JWKS fetch threw inside the
catch-all and became 404. It is now AccessUnavailableError -> 503.

**Every server crash was reported as "Session expired".** fetch() had no
try/catch, so any throw became a Cloudflare 1101 with an HTML body - and both
admin pages sniff Content-Type and report exactly that string. The single most
misleading diagnostic in the admin surface, and it hid real D1 and GitHub
failures. Dispatch moved into route(); fetch() wraps it and logs the detail.

**A failed audit row reported a successful write as failed.** audit() was
awaited AFTER the commit landed and outside any try, so a D1 hiccup told the
reviewer the approval failed when it had already committed - and they would
retry it. Now best-effort with a loud log. edit.ts had its own copy of the
INSERT with the same defect; both use lib/audit.ts.

**A reject could downgrade an approval.** reconcile.ts writes
ingest_decisions('approved') only after observing the appid in data/, using DO
NOTHING; reject used a bare DO UPDATE, so the two disagreed about who may
overwrite whom. Added `WHERE ingest_decisions.decision <> 'approved'`, verified
against a real local D1: the approved row keeps its decision, reason and
attribution, the rejected row still updates.

**header_image was unvalidated.** Length-capped only, then rendered in an <img>
on the review screen; the page CSP happened to block it, which is the wrong
thing to rely on. Now must be a Steam CDN URL. Caught while testing: 100% of
the 3,665 real header_image values carry `?t=<mtime>`, so a pattern without it
would have blanked every queued game's image. All 3,665 pass; evil.com,
javascript:, data:, and the steamstatic.com.evil.com suffix trick do not.

**Concurrent reconciles.** The 15-min cron and the manual button could both run
a ~6MB fetch, and the button has no busy state. Added a per-isolate in-flight
guard, with a comment honest about its scope: cross-isolate overlap is still
possible and is left alone because every write there is idempotent.

**/api/admin/health echoed raw D1 and GitHub error text**, the latter including
GitHub's response body via github-app.ts. Now a status enum; detail to logs.

## Tests

19 tests. override-doc.test.ts round-trips the four REAL committed
data/overrides/*.json files - all Python-written - through the TypeScript
serialiser and asserts byte equality, which tests the actual property against
actual production data rather than a fixture written to match the code. edit.ts
now calls that shared serialiser instead of an inlined copy, so the test covers
the path that runs.

Verified the tests can fail: three mutations (old clamp expression, dropped
trailing newline, indent 4) each turned them red.

Wired into web-ci.yml, and into check-overrides.yml - which did not trigger on
web/worker/routes/edit.ts, so the "change one, change the other" mirror had no
CI enforcement in either direction.

## knip was blind to the entire Worker

knip.json's project globs were src/** only. Adding worker/** immediately found
five dead exports in the module holding the repo-write credential: commitFile
(deleted - an unused wrapper), readHeadAndFile, installationToken,
MANUAL_FIELDS and adminCsp (all now module-private). worker/env.d.ts is
ignored: it is an ambient declaration nothing imports by design.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 12:25:00 +07:00
poli0981andClaude Opus 5 3525554eb6 feat(worker): proxy GitHub avatars and the commit feed, add security.txt
Fixes two of the five reported console errors, and narrows the site CSP to
connect-src 'self' as a consequence.

## The avatar error

  Loading the image 'https://avatars.githubusercontent.com/in/15368?v=4'
  violates the following Content Security Policy directive: "img-src ..."

Activity.tsx rendered commit.author.avatar_url straight from the GitHub API.
avatars.githubusercontent.com appears in NONE of this repo's four CSPs
(_headers, admin-ui, edit-ui, tauri.conf.json), so every avatar on /activity
was blocked - in the browser and in both packaged apps. `in/15368` is the
pipeline's GitHub App; verified live, the page requests exactly three avatars
(in/15368, in/29110, u/127664709).

Widening img-src was the smaller diff and the wrong call: it puts a
third-party host back in the page and hands every visitor's IP to GitHub,
which PRIVACY_POLICY.md says does not happen. Instead /img/gh/{u|in}/{id}
proxies them, reusing the existing /img/ prefix so run_worker_first and the
service-worker CacheFirst rule both needed no change. Anchored regex, digits
only, fixed 56px size (a caller-chosen size is unbounded cache keys).

## /api/activity

The commits fetch was the last third-party request the public app made. It now
goes through the Worker, which also lets connect-src drop to 'self'.

Two things the proxy deliberately drops, both found by reading live output:

- commit.author.email, which GitHub returns for every commit and the page
  never used. Forwarding it would make this a bulk email-harvesting endpoint
  for everyone who has ever contributed.
- the commit message BODY. Only the subject line is rendered, and the bodies
  here carry Co-Authored-By trailers with real addresses - the first version
  of this route shipped them to every visitor from a publicly edge-cached
  response. Sending the subject only also cut the payload 98,203 -> 30,324
  bytes.

Edge-cached 5 minutes, keyed on the path alone so `?x=1` cannot mint cache
entries and walk past that. This bounds upstream traffic to ~12 calls/hour
against GitHub's anonymous budget of 60/hour, which a pass-through would
exhaust immediately since a Worker egresses from a shared address. It is NOT
authenticated: the GitHub App token is a repo-write credential and has no
business on a public route. Carries ACAO: * for the same reason /api/data/*
does - the Tauri builds read it cross-origin from tauri://localhost.

## security.txt

web/public/.well-known/security.txt (RFC 9116). It had to be a real file:
not_found_handling is "single-page-application", so a request for it returned
dist/index.html at HTTP 200 and scanners got a web page with no error.
Verified it now returns text/plain. Expires 2027-09-01; renewal is logged as a
recurring task in SECURITY_SETUP.md.

## Header gaps found while in here

- worker/index.ts's unauthenticated /admin 404 shipped NO security headers -
  it was the one response built by hand instead of through jsonError. It now
  uses withSecurityHeaders(), which was exported and never called.
- admin-ui.ts and edit-ui.ts contained byte-identical copies of the CSP for
  the only origin holding a repository-write credential. Extracted to
  adminCsp()/adminHtmlResponse() in lib/http.ts; a hardening change applied to
  one copy and not the other is invisible. Adds an explicit object-src and the
  Cross-Origin-Opener-Policy the SPA had and these pages did not.
- SITE_ORIGIN was duplicated in fetcher.ts and image.ts with the same comment.
  A third caller made lib/site.ts the right shape.

## Two things the maintainer must do, both dashboard-only

Recorded in SECURITY_SETUP.md sections 2 and 9:

- HSTS preload: the header already carries `preload` and the domain passes
  hstspreload.org's preloadable check with {"errors": [], "warnings": []},
  port 80 301s to HTTPS. Status is still "unknown" = not submitted. Submission
  is irreversible on any useful timescale, so it is yours to make.
- Cloudflare Web Analytics is ON and injecting static.cloudflareinsights.com's
  beacon at the edge, which our own script-src 'self' blocks - two CSP errors
  on every page load of the live site, and analytics that have never collected
  anything. Not in the repo; curl of the deployed HTML shows no such tag.
  Recommend turning it off rather than allowlisting, since the privacy policy
  promises no third-party resources.

Verified against a local `wrangler dev`: avatars 200 through the proxy, all
malformed avatar paths 404, Steam variants unaffected, /api/activity
unauthenticated and 200, /api/data CORS intact, /admin 404 now carrying
headers, and zero requests to any GitHub host from the browser. typecheck,
build, wrangler --dry-run and knip all pass.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 12:10:52 +07:00
poli0981andClaude Opus 5 56559a13f6 docs(contact): move to contact@poli0981.dev and one links page
Nine maintainer channels collapse to two: the email, and
https://poli0981.dev/links/ as the single source of truth for everything
else. Handles now live off-repo so a retired account cannot strand a dead
link in a shipped build — which had already happened three times.

Replaced lopop05905@proton.me at all 6 sites (AUTHORS.md, SECURITY.md,
docs/Contact.md, username.txt, and both the handle and the mailto: href in
About.tsx). Edited by hand rather than by regex: a naive email pattern
misses the 10 `github-actions[bot]@` occurrences and matches things that
must not change (the you@example.com placeholder, 128x128@2x.png, the
data/overrides set_by identities, ~200 `uses: …@v6` action pins).

Stale content removed or corrected while in here:

- CONTRIBUTING.md carried a whole WARNING block about whitelisting a
  Telegram user_id for a bot that no longer exists. Replaced with a
  general "public and permanent" privacy note.
- docs/Contact.md had an orphaned bullet body (lines 17-19) left behind
  when the Telegram ingest bot was deleted — no title line, dangling
  arrows. Section rewritten; it now says outright that the bot and the
  issue template are gone and the extension is the only submission path.
- docs/ADMIN.md credited temp_info.jsonl's appends to "the issue workflow
  and the Telegram bot". Both are gone; the producers are the extension
  and this Worker.
- README.md described CONTRIBUTING as covering "web-app sign-in, Telegram
  bot flow" (both removed) and ToS.md as holding Telegram user_id rules
  (it no longer mentions them).
- CODE_OF_CONDUCT.md had no reporting address at all. Added one.
- Two legacy /#/about URLs now point at the real /about path.
- Deleted the dead Telegram QR assets and the About page card that
  displayed one.

Licensing claims corrected in AUTHORS.md and twice in About.tsx: all
three still said the whole repo including data was MIT. The dataset moved
to CC BY 4.0 in LICENSE-DATA and these were the last places asserting
otherwise.

SECURITY.md's parenthetical claimed the address was published in
CONTRIBUTING.md — it never was, only a pointer. Replaced with the real
list plus a forward reference to the security.txt added next.

typecheck and build pass; knip reports only the pre-existing backlog.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 11:53:40 +07:00
github-actions[bot] 86af6cf0b3 Auto update [2026-09-12] 2026-09-12 02:47:40 +00:00
github-actions[bot] e11f5eabce Snapshot [2026-09-12] 2026-09-12 00:58:30 +00:00
github-actions[bot] 5a7113dfcc Update reviews [2026-09-11] 2026-09-11 12:41:45 +00:00
github-actions[bot] c2837dfe70 Dead link check [2026-09-11] 2026-09-11 10:30:24 +00:00
github-actions[bot] c40bf8479a Ingest games [2026-09-11 08:15] 2026-09-11 08:15:34 +00:00
f2p-tracker-admin[bot] 657d71b9bd queue: 60 approved games
Approved in /admin by k30021424@gmail.com.

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-09-11 08:05:57 +00:00
github-actions[bot] dfb52387e5 Ingest games [2026-09-11 03:44] 2026-09-11 03:44:23 +00:00
f2p-tracker-admin[bot] d4b1ceef43 queue: 60 approved games
Approved in /admin by k30021424@gmail.com.

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-09-11 03:39:27 +00:00
github-actions[bot] 04eb341a26 Ingest games [2026-09-11 03:27] 2026-09-11 03:27:51 +00:00
f2p-tracker-admin[bot] 4841584565 queue: 60 approved games
Approved in /admin by k30021424@gmail.com.

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-09-11 03:23:01 +00:00
github-actions[bot] 262ea97b73 Ingest games [2026-09-11 03:09] 2026-09-11 03:09:25 +00:00
f2p-tracker-admin[bot] 22bdab747a queue: 60 approved games
Approved in /admin by k30021424@gmail.com.

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-09-11 03:04:22 +00:00
f2p-tracker-admin[bot] 19da80b4d2 override: Frog Climb (genre)
Edited in /admin by k30021424@gmail.com.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-11 03:03:03 +00:00
f2p-tracker-admin[bot] 0a04d5d18c override: Don't Knife Me! (genre)
Edited in /admin by k30021424@gmail.com.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-11 02:39:09 +00:00
github-actions[bot] 6f3057d355 Auto update [2026-09-11] 2026-09-11 02:38:28 +00:00
f2p-tracker-admin[bot] 7ee0ac9398 override: Hexpand (genre)
Edited in /admin by k30021424@gmail.com.

Reason: change to RTS

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-11 02:25:09 +00:00
github-actions[bot] bd1d1d66dc Snapshot [2026-09-11] 2026-09-11 00:52:57 +00:00
poli0981andClaude Opus 5 a64cf6e718 chore(release): 1.4.5 / v3.4.3
App 1.4.4 -> 1.4.5 (web, desktop, Android); repo 3.4.2 -> 3.4.3. Same files
the previous release commits touched: package.json, package-lock.json,
Cargo.toml, Cargo.lock, tauri.conf.json, the README badge, and a CHANGELOG
entry covering everything since v3.4.2 - the move to free-steam-games.win, the
discovery + /admin review flow, durable overrides, the CC BY data licence,
description truncation, real URLs, security headers, and the Tauri CSP + CORS.

The Android versionCode is derived by Tauri from `version`, so
build.gradle.kts is untouched. Both binary workflows publish DRAFT releases;
the packaged builds must be smoke-tested before they are published.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-11 07:26:29 +07:00
poli0981andClaude Opus 5 bc625f285e docs(security): correct rate limiting and Bot Fight Mode for the Free plan
The setup guide recommended two rate-limiting rules at one minute each with
Managed Challenge. The Free plan allows exactly ONE rule and fixes most of it:
IP counting only, a 10-second period, a 10-second timeout, path and
verified-bot fields only, cached requests counted. Rewritten as the single rule
this site should have: /img/* and /api/data/* together, 150 requests per 10
seconds, Block, verified bots excluded. Block is tolerable precisely because
the Free timeout is fixed at 10 seconds — a false positive costs ten seconds of
missing thumbnails, not a lockout.

It also said to turn Bot Fight Mode on. That was wrong for this site.
Cloudflare documents that it "may challenge API or mobile app traffic" and that
it cannot be bypassed with WAF custom rules or Page Rules. The desktop and
Android apps fetch /api/data/* with plain fetch() and the discovery workflow
calls /api/ingest/* from GitHub Actions — a challenge page would break both,
with no way to exempt them short of allowlisting GitHub's runner ranges. The
guide now says to leave it off, and why.

HSTS: the guide and web/public/_headers now say where it comes from. It is set
by the Cloudflare zone and stamps every response, static and Worker alike,
verified live on /, /api/data/* and /assets/*. It is deliberately not repeated
in code, which would risk a second Strict-Transport-Security header — browsers
honour only the first.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-11 07:25:16 +07:00
poli0981andClaude Opus 5 040032034d fix(tauri): CORS for the next packaged build, and a real CSP
## The regression

The desktop and Android apps fetch the catalogue with plain fetch() from
https://free-steam-games.win/api/data/*. Their origin is http://tauri.localhost
(Windows/Android) or tauri://localhost (macOS/Linux), so that is a cross-origin
request. Before the Cloudflare migration they fetched raw.githubusercontent.com,
which answers every origin with `Access-Control-Allow-Origin: *`. The Worker
proxy that replaced it sent no CORS header at all.

Verified with real Origin headers against production: raw.githubusercontent
returns `*`; free-steam-games.win returned nothing for either Tauri origin.

The released apps were never affected: desktop-v1.4.1 and android-v1.4.4 were
built before the migration and still read raw.githubusercontent directly. The
bug was latent — ANY build made from main since the migration could not load
the catalogue, so it would have shipped in the very next release. This fix is
therefore a prerequisite for tagging 1.4.5, not a repair of the field.

/api/data/* now sends `Access-Control-Allow-Origin: *`. `*` is right for
exactly this route: it is the same public dataset raw.githubusercontent serves
to everyone with `*`, and no credentials ride on it. Verified locally that both
Tauri origins get it and that /api/admin/* still returns no CORS header at all
— it must never be copied there. Images need nothing: they load through <img>,
which does not use CORS, and nothing in the app sets crossOrigin.

## The CSP

tauri.conf.json had `csp: null`. It now has a policy mirroring the web one,
plus what the webview specifically needs:

- `connect-src ipc: http://ipc.localhost` is REQUIRED. Without it every
  invoke() — shell:open, the updater, the http plugin — fails silently, and
  none of that reproduces under `tauri dev`.
- https://free-steam-games.win in connect-src and img-src, since in Tauri the
  data and /img/* are cross-origin rather than 'self'.
- script-src 'self' is safe: Tauri appends nonces/hashes for its own injected
  scripts at compile time.

`cargo check` passes, so the config parses and the capability ACLs resolve.
What it cannot prove is runtime behaviour in a packaged build; that needs a
smoke test before the next desktop-v* tag — open the app, confirm the
catalogue loads, click an external link (shell:open), and let the updater run.
Committing this does not ship a binary; releases are tag-driven.

Also corrects bundle.longDescription, which still claimed 1,200+ games, an
editor, and data read from raw.githubusercontent.com.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-11 07:25:16 +07:00
poli0981andClaude Opus 5 2862d20878 feat(web): real URLs — BrowserRouter on the web, HashRouter in Tauri
Every URL was /#/games/730. Hash routes are not shareable in any meaningful
sense and are not indexable: search engines drop the fragment, so the whole
catalogue collapsed to one page in their eyes.

The router is chosen per platform. The web gets BrowserRouter, which works
because the Worker's `not_found_handling: "single-page-application"` serves
index.html for any path — verified: /charts/genres, /games/730 and /about all
return 200 text/html. Tauri keeps HashRouter, because its webview serves the
bundle from its own asset protocol with no such fallback, and a real path
would 404 on refresh.

Old links keep working. upgradeLegacyHashUrl() rewrites /#/charts/genres?x=1
to /charts/genres?x=1 before the router first reads the URL, with
replaceState so Back does not bounce to the old form. Only `#/…` is rewritten;
an in-page anchor like /charts/anti-cheat/list#vac is left alone. Both
verified in a browser on a full page load — the upgrade runs on load, which is
exactly when a bookmark or a search result is opened.

Two hardcoded hrefs assumed the hash router: "#/health" in the game drawer and
`#/games?search=…` on the Health page. Under BrowserRouter those resolve to
the current page plus a fragment, i.e. they silently stop navigating. Both are
router <Link>s now, which render /health on the web and #/health in Tauri.

The service worker needed no change: its navigateFallbackDenylist already
excludes /api, /img and /admin, so a navigation to /admin still reaches the
Worker instead of being answered with the cached SPA shell.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-11 07:25:16 +07:00
poli0981andClaude Opus 5 e2b2187ee4 feat(data): truncate description to 180 chars
The field held each publisher's store blurb verbatim — median 213 characters,
longest 340. At that length it reproduced whole blurbs rather than quoting from
them, which is not what LICENSE-DATA claims it does when it calls them "short
identifying quotations" and excludes them from the CC BY grant. This makes the
claim true.

Measured: 2,156 of 3,426 rows (63%) shortened, data/ 671 KB -> 517 KB (-23%),
no stored value now exceeds 180 characters.

Truncation happens in exactly ONE place — save_main(), the same choke point
apply_overrides() uses. `description` has three write paths (apply_details in
fetcher.py, merge_extension_data and the legacy desc->description migration in
data_store.py), so putting it at any of them would have left the others
producing full-length values and the shards flip-flopping between writers.
save_main() is the only code that writes data/data_*.jsonl, so covering it
covers everything, including any future writer.

Idempotent by construction: the result is always <= the cap, so a second pass
returns it unchanged. Verified on the real catalogue — a second run reports 0
records changed. That property is load-bearing rather than nice-to-have,
because this runs on EVERY write to data/; without it the truncator would nibble
a character off every description on every run and rewrite all five shards
forever.

Cuts on a word boundary when one falls in the last 40% of the budget, so a
blurb whose tail has no spaces keeps its text instead of losing most of it, and
the ellipsis is included in the 180 rather than pushing past it. Verified
byte-level: U+2026, e2 80 a6, not a mojibake three-dot.

Deliberately does NOT bump each record's last_updated. That field means the
game's data changed; shortening how much of a publisher's blurb this repository
stores is a change to our representation, not news about the game. Bumping it
would have shown ~2,150 games as freshly updated on the Activity and Health
pages on the day this first ran.

Ordered before apply_overrides() so a human decision always has the last word —
no override can set `description` today, but the ordering should not depend on
that staying true. Confirmed the live override (Draw Party, genre) survived the
full-catalogue rewrite intact.

The blurb is now attributed where it is actually read, not only in
LICENSE-DATA: the detail drawer carries a "Blurb by the publisher, via Steam —
shortened" line, translated in both locales. LICENSE-DATA's figures updated to
match the new shape.

Note this rewrites every shard, so index.json.last_updated moves and every
client's IndexedDB cache invalidates at once. That is expected and is why this
is its own commit.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-11 07:24:15 +07:00
poli0981andClaude Opus 5 3b4ece183c feat(security): CSP and hardening headers, plus a verifiable setup guide
The site had NO Content-Security-Policy. Static assets carried only HSTS (added
by Cloudflare at the edge) and X-Content-Type-Options; Worker responses carried
three headers. That is the gap this closes.

web/public/_headers covers static assets, worker/lib/http.ts covers everything
the Worker generates, and neither inherits from the other — a header that must
hold everywhere has to be added twice. Said so in both files.

The CSP was VERIFIED, not assumed: built the app, served it under the policy,
and walked /games, four chart pages, /about and /health. Zero console errors,
zero violations, images and lazy chunks all loading.

Two directives are shaped by measurement:

- style-src needs 'unsafe-inline'. Radix positions popovers and dialogs with
  inline style attributes and ECharts sizes its canvas the same way — /games
  alone renders 471 inline-styled elements. It is the acceptable half of the
  trade: no user-supplied HTML is ever rendered, and script-src stays strict,
  which is the directive that actually stops execution.
- script-src 'self' is safe despite an inline <script> in index.html: it is
  type="application/ld+json", a data block that is never executed, so
  script-src does not govern it. Checked the BUILT output, not the source.

Cross-Origin-Resource-Policy is deliberately static-only. Setting it on Worker
responses would have broken the Tauri desktop and Android builds, which run on
tauri://localhost and fetch /api/data/* and /img/* from this origin cross-site
(SITE_ORIGIN in src/lib/fetcher.ts and src/lib/image.ts) — every image blank,
catalogue never loading. Caught before shipping; the reason is in the code.

docs/SECURITY_SETUP.md documents what remains, each item with a command to
check it, because a setting you believe is on and is not is worse than one you
know is off. Two findings in it are worth surfacing here:

- HSTS is already max-age=31536000; includeSubDomains; preload — the maximum.
  The domain is NOT on the preload list (hstspreload.org status: "unknown"),
  but the list accepts submissions from ANYBODY for a domain whose header
  advertises `preload`. Leaving the directive in means a third party can put
  the domain on a list that takes months and a browser-vendor process to leave.
  Either submit deliberately or drop the directive.
- Rate limiting belongs in a WAF rule, not in the Worker. A dashboard rule
  rejects at the edge before the Worker runs; a Worker-side limiter has already
  paid for the request by the time it says no, which is backwards for cost
  control. Thresholds given (600/min for /img/*, 120/min for /api/data/*) are
  derived from a measured session — /games issues index.json + 5 shards + ~30
  thumbnails in one burst — not from a template.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-11 00:41:20 +07:00
poli0981andClaude Opus 5 122075c9bf feat(admin): genre dropdown, bulk retag; ingest reduced to the extension
## /admin/edit

Genre is a dropdown instead of free text, built from the genres ACTUALLY in
use with their counts — the counts are the point, since they are how a vague
bucket announces itself ("Action" holds 287 games, "Adventure" 232). A
"Custom…" option still allows a value the catalogue has never used, and the
game's current genre is always offered even when absent from that list, so
loading a game can never silently change it.

New "Bulk by genre" mode: pick a genre, see everything carrying it, retag up
to ten in ONE commit. The cap is enforced in the UI (remaining checkboxes
disable, with "limit reached") and again on the server.

Supporting work:
- commitFiles() replaces commitFile(): several files in one commit, reading
  the head and every file in ONE aliased GraphQL query so expectedHeadOid
  still means what it says across ten files. Ten commits would be ten pushes,
  ten workflow triggers and ten chances to land half a change.
- listByGenre() and genreCounts() in records.ts. Genres are counted by regex
  over shard TEXT rather than parsing 3,426 records — verified to agree with a
  full parse exactly (92 distinct, 3,426 games). listByGenre prefilters by
  substring and only then parses, so cost scales with matches, not catalogue
  size; an exact field check rejects the substring appearing in a description.

Found by driving the page: renderBulk() rebuilt all 60 cards on every checkbox
click, replacing the element just clicked and losing keyboard focus. Selection
now updates in place.

## Ingest: extension only

Removed the GitHub-issue and Telegram paths. Kept the browser extension, which
pushes to scripts/temp_info.jsonl directly, plus the /admin approve flow that
appends to the same file.

Deleted: bot-ingest.yml, ingest-from-issue.yml, ISSUE_TEMPLATE/add_games.yml,
docs/telegram-bot.md, and both copies of the bot QR.

Four things would have broken, and a fifth was already broken:

- BUILD BREAK. web/tsconfig.json sets noUnusedLocals, so removing the Telegram
  and add-games UI orphans the PlusCircle and Bot icon imports — four TS6133
  errors, web-ci red, site unbuildable.
- A live button. About.tsx linked issues/new?template=add_games.yml; GitHub
  silently ignores an unknown template and drops the user on a blank form.
- CommandPalette linked "/add" — a route that does not exist. Every
  `<Route path=…>` in web/src confirms it: left behind when sign-in and
  in-app editing were removed, so selecting it navigated to the 404 page.
- notify-ci-failure.yml matches by exact workflow NAME and its own comment
  warns a stale entry breaks silently.
- ALREADY BROKEN: README and CONTRIBUTING both linked
  poli0981/free-steam-games-list-extension, which does not exist
  (`gh repo view` → "Could not resolve"). The real repo is
  poli0981/steam-f2p-extension. That was the link to the one path being kept.

README's Contribute section and CONTRIBUTING §2 still documented signing into
the web app with a Classic PAT — removed months ago. Both rewritten: the
extension is the submission route, issues are for reports, and discovery plus
/admin is how most games actually arrive now.

docs/ToS.md §5.1 governed sending a Telegram user_id to a bot that no longer
exists; removed, and TERMS_VERSION bumped 2 → 3 because ConsentGate exists to
re-ask when the terms change. Workflow counts corrected 24 → 23 in README and
SECURITY.md.

Kept deliberately: the maintainer's own @SkullMute0011 DM row and its QR, with
the "whitelist requests" framing dropped — that is a contact channel, not part
of the ingest path.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-11 00:31:27 +07:00
f2p-tracker-admin[bot] 7e9aba9667 override: Draw Party (genre)
Edited in /admin by k30021424@gmail.com.

Standing instruction re-applied by save_main() on every write to data/. See scripts/core/overrides.py.
2026-09-10 17:04:12 +00:00
poli0981andClaude Opus 5 fa2afd68d5 feat(admin): /admin/edit — correct a published game from the browser
Stage 2. The Worker writes the same artifact scripts/edit_game.py writes,
data/overrides/<appid>.json, so the two producers are interchangeable and this
screen is presentation over a mechanism that already worked without it. The
Worker still never touches data/.

  GET  /api/admin/game?appid=   current values + any existing override
  POST /api/admin/edit          set and/or retire fields
  /admin/edit                   the page, linked from the review queue

Reading one record out of 6 MB. worker/lib/records.ts fetches shards as TEXT,
finds the literal `/app/<appid>/`, slices that line to its newline boundaries
and JSON.parses only it — the needle is anchored on both sides by the canonical
link format, so it cannot match a longer appid or hit text inside a
description, and the record is re-checked against its own `link` because the
needle can legitimately appear in a note. Shard names come from index.json
rather than being hardcoded, and which shard a record was found in is never
retained: save_main() re-chunks the catalogue every run, so that fact is true
only for one request.

git-commit.ts gains a generic commitFile() sharing appendLinks' retry, and an
anchored path ALLOWLIST. The App credential can write anywhere in the
repository; WRITABLE is what stops a bug upstream from turning that into a
general-purpose commit engine. data/ shards are not on it and must never be.
commitFile()'s builder is re-run on every retry against the file's current
text, so losing a race merges rather than clobbers.

Two properties are asserted rather than assumed, because both fail silently:

- The Worker's JSON output is BYTE-IDENTICAL to save_override()'s. Verified at
  651 bytes each on a document containing non-Latin text, quotes, a backslash
  and an embedded newline. Had the formatting differed, every edit alternating
  between the CLI and the UI would have produced a whole-file diff.
- The Worker's validateValue() agrees with Python's validate_value() on 23
  cases, including the ones that matter: `is_kernel_ac` as the STRING "true"
  is rejected by both, a numeric genre is rejected by both, and both refuse an
  empty value with the same reason.

The Worker's validator is deliberately the weaker copy. Python is
authoritative, runs on every pipeline write, and check-overrides.yml runs it on
every push — and because the App token is not GITHUB_TOKEN, an override commit
triggers that workflow. So a file the UI accepts but Python would reject fails
CI within a minute instead of sitting inert.

`was` is read server-side from the catalogue and never taken from the request.
It is the value Retire restores, so a client-supplied one would let a crafted
request rewrite history.

Verified by driving the real page in a browser against a stubbed API, which
caught a bug reading alone did not: save() set the result banner and the reload
that followed wiped it — the same defect fixed earlier in admin-ui.ts, and it
was present on both the save and retire paths. Also confirmed: dirty tracking
clears when a field is typed back to its original, the boolean select sends a
real `true` rather than the string, an unknown appid surfaces the API error
instead of a blank form, and the `<script>` payload in a game name renders as
text.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 23:56:45 +07:00
poli0981andClaude Opus 5 dbbd035a6d feat(data): human overrides — corrections that survive the pipeline
Stage 1 of editing existing games. Python only: no Worker, no D1, no new
credential, no UI. The client is the command line.

The problem it solves. MANUAL_FIELDS (anti_cheat, anti_cheat_note,
is_kernel_ac, notes, type_game, safe, genre) are protected only by
fill-if-empty — a scrape will not overwrite a non-empty value. That cannot
tell a human correction from earlier scraper output, so
`normalize_genres.py --apply`, which rewrites genre for EVERY game, silently
reverts a fix, and refetch_all.py re-fetches everything. Nothing in the repo
recorded that a human had ever decided anything.

So an override is not a one-time edit. It is a standing instruction at
data/overrides/<appid>.json, and apply_overrides() is called from inside
save_main() — verified to be the single choke point: 11 scripts call it and
grep finds nothing else writing data/data_*.jsonl. The correction is therefore
re-imposed as the last act of every write, and no script needs to know this
layer exists. Any future dataset writer inherits it for free.

Four designs were explored independently and all four converged on this same
hook, which is the main reason to trust it. Direct shard-writing from the
Worker was rejected by every judge: shard identity is unstable (save_main
re-chunks from scratch, so a game moves between shards), the commit must carry
a whole file, and index.json has to be bumped in the same commit.

Three rules that are not obvious, each of which is a real trap:

- An override may NOT set a field empty. The next scrape would refill it and
  this layer would blank it again, rewriting shards on every run forever.
  Clearing is what retiring is for; empty values are refused with that message.
- Retiring is not deleting. Deleting the file leaves the field pinned to the
  human value, because fill-if-empty never restores the old one. A retired
  entry keeps `was`, writes it back once, then permanently no-ops because the
  values no longer match — self-cleaning and idempotent by construction.
- `notes` is shared with the pipeline, which appends its own segments
  (Dead game / Delisted / No longer free!). Those appends are ONE-WAY:
  mark_dead_games.py only calls append_note_idempotent() while is_dead is
  False, so once a game is flagged the marker is never re-added. A plain
  whole-value override of notes would erase it permanently, with nothing able
  to restore it. preserve_machine_notes() re-attaches any marker the human
  value would drop; the marker strings are asserted against their real
  producers.

Deliberately tolerant at apply time: an unknown field, a bad value, a game no
longer in the catalogue, or a malformed file is counted and reported, never
raised — a typo must not abort a run that has already spent two hours scraping.
That tolerance is also why silence would be dangerous, so
.github/workflows/check-overrides.yml validates every override on push and PR.

Verified against the real dataset: 20 assertions covering apply, idempotency
(a second pass rewrites nothing and does not re-bump last_updated), survival of
a simulated refetch and of normalize_genres, marker preservation on appid
3632680 (a genuinely dead game carrying the marker), retire-then-inert,
rejection of all four bad-input classes, orphans, and one malformed file not
stopping the others. An end-to-end `--apply` on the live catalogue produced
exactly one changed line in one shard plus index.json.last_updated — no shard
churn. With no overrides present the hook costs one isdir() and returns.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 23:47:24 +07:00
poli0981andClaude Opus 5 192f17622f chore: drop the bulk generated markdown, keep the two leaderboards
games/ held 1.8 MB of markdown regenerated from data/*.jsonl on every data
change: 18 all-games_part*.md files, anti-cheat-list.md, a README index of
them, and a .gen-hash checksum whose only purpose was to make regenerating
them cheaper. The web app has been the way to browse the catalogue since v3.0,
so these were a second rendering of the same records that had to be rebuilt,
committed and reviewed forever.

Kept: games/top-online.md and games/top-offline.md.

Removed with them, because nothing else used them:
  scripts/generate_tables.py, scripts/generate_anti_cheat_list.py
  .github/workflows/update-daily.yml ("Generate Markdown Tables")
  .github/workflows/anti-cheat-list.yml
  bash/daily.sh, bash/anti_cheat.sh
and the generate_tables call inside ingest.sh, purge.sh, refetch_all.sh and
ingest-from-issue.yml.

Nothing depended on the anti-cheat markdown: /charts/anti-cheat reads
data/*.jsonl, not that file.

Four references would have broken, two of them user-visible:

- web/public/sitemap.xml advertised all-games_part1.md to search engines, and
  About.tsx had an "All games (markdown)" button. Both would now 404. The
  sitemap entry is gone; the button points at data/ instead.
- .github/workflows/mark-dead-games.yml ended with
  `gh workflow run "Generate Markdown Tables"`. That command exits non-zero
  against a workflow that does not exist, so every successful dead-games run
  would have finished red.
- notify-ci-failure.yml's allowlist is matched by exact workflow NAME, and the
  file's own comment warns that a stale entry breaks silently.

Also fixed the stale poli0981.github.io URL in the bug-report template while
removing its games/*.md option.

Verified: typecheck, build, all 24 workflow YAML files parse, sitemap.xml is
well-formed, and no reference to the removed files survives outside CHANGELOG
and docs/plan (both historical).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 23:23:41 +07:00
github-actions[bot] 07922326e7 Ingest games [2026-09-10 16:09] 2026-09-10 16:09:04 +00:00
f2p-tracker-admin[bot] eb5d2465ab queue: 2 approved games
Approved in /admin by k30021424@gmail.com.

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-09-10 16:08:45 +00:00
poli0981andClaude Opus 5 38a30be9ad fix(admin): second review round — retry classification, status guards, docs
Re-ran the review that had 27 of 49 verifier agents die on a usage limit, this
time adjudicating each unverified claim against current code. 22 agents, none
failed. Most of the outstanding claims did not survive; four did.

**The retry was dead code.** appendLinks classified a stale-head rejection by
regex over GitHub's prose, requiring the literal substring "oid". GitHub
actually answers with type "STALE_DATA" and the message `Expected branch to
point to "<sha>" but it did not. Pull and try again.` — where the only variable
span is a hex sha, whose alphabet contains neither 'o' nor 'i'. So the pattern
could never match, the first lost race rethrew immediately, and MAX_ATTEMPTS
was unreachable for the one purpose the module documents it for. Worse, the
alternation DID match `Ref cannot be updated` — a permanent branch-protection
rejection — burning four round trips before reporting it as a race.

Now classified by fact rather than wording: the machine-readable "STALE_DATA"
type as a fast path, falling back to re-reading the head and comparing. If the
branch moved we lost a race and retrying is right; if it did not, the failure
will repeat identically and belongs in front of the operator now.

**reject and defer/requeue could overwrite a decided row.** approve carried
`AND status IN ('pending','deferred','failed')` on its UPDATE; the other two
used a bare `WHERE id=?`. Rows are pre-filtered by DECIDABLE when read, but
that is TOCTOU — an admin page held open across a reconcile, or two reviewers
acting at once, and a stale page could reject a game whose approval had already
been committed to Git, or one already published. All branches now carry the
guard, with a note at DECIDABLE saying why it is enforced twice.

**A reconcile that failed outright looked like success.** The "ok" argument sat
outside the ternary, so `index unreachable` and `shard unreachable` painted the
green banner. Split on the row count rather than the message — bail() always
reports checked >= 1 and the benign idle skip reports 0 — so it will not drift
when the wording changes. The banner now also reports aged-out rows and says
what to do about them, which the API returned and the UI discarded.

**docs/ADMIN.md never caught up with the per-route AUD refactor.** It still told
operators to add new AUDs to `ACCESS_AUD`, a var that no longer exists, and
still documented `INGEST_SERVICE_PRINCIPAL` and a `ingest: principal not
allowed` log line that were both removed in ed30c5da. Following it would
produce exactly the `aud mismatch` the section exists to prevent. Corrected,
with the two per-route vars tabulated, plus a table of the three
`reject_reason` values a `failed` row can carry and what each requires.

One correction the adjudicator made to itself, kept: renaming the service token
is NOT harmless. The Worker-side name check is gone, but the name still has to
match the Service Token rule in the Access policy.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 23:01:29 +07:00
poli0981andClaude Opus 5 16fa13dd3c feat(admin): review queue at /admin, approve-to-commit, reconcile cron
Completes the human side of the ingest pipeline. 646 discovered games were
sitting in D1 with no way to act on them except wrangler d1 execute.

  /admin                     review screen, served BY THE WORKER
  POST /api/admin/decide     approve / reject / defer / requeue, in bulk
  POST /api/admin/reconcile  run the reconciler now
  GET  /api/admin/stats      per-status counts for the tabs
  worker/lib/git-commit.ts   GraphQL createCommitOnBranch -> temp_info.jsonl
  worker/lib/reconcile.ts    promotes 'approved' only after seeing data/
  scheduled()                the same pass, every 15 minutes

The page is served by the Worker rather than added to the SPA. The public app
has no sign-in and no editing — that was removed deliberately — so admin markup
and endpoint names have no business in a bundle every visitor downloads, and
/admin cannot fall through to the public shell if a route changes. It ships its
own CSP with a per-response nonce; every value from Steam or D1 is written with
textContent.

The three actions are deliberately asymmetric:

  reject   final and local. Writes ingest_decisions('rejected'), which is what
           actually stops tomorrow's sweep re-offering the game — the partial
           unique index only covers OPEN rows.
  defer    parks the row while keeping the appid blocked.
  approve  does NOT publish. It appends to scripts/temp_info.jsonl and stops.

Approve stopping there is the whole design. ingest_new.py still decides whether
a game is real, free and reachable, so a commit is a REQUEST, not an outcome.
Only reconcile.ts, after observing the appid in data/, may write
ingest_decisions('approved') — because /api/ingest/known feeds decided appids
back to the discovery sweep, and marking something decided that never got
published makes it invisible to every future sweep.

Commits use createCommitOnBranch so GitHub signs them (Verified), carry
expectedHeadOid so a concurrent pipeline commit is retried against the newer
file rather than overwritten, and APPEND — the issue workflow and Telegram bot
write to that file too. Because the App installation token is not GITHUB_TOKEN,
the push triggers Ingest New Game Links on its own.

Verified before committing: the page was rendered and driven in a real browser
against a stubbed API (Access makes /admin unreachable to anything but the
owner's login). That caught three bugs a read-through did not — the commit
confirmation being wiped by the reload that followed it, the master checkbox
staying ticked with nothing selected, and unsequenced loads letting a stale
response paint under the wrong tab.

An adversarial review of this code found more, of which the serious ones:

- A game could be lost permanently and silently. ingest_new.py SKIPS an entry
  that hits a network error, writes nothing to removed_games.jsonl, then clears
  temp_info.jsonl regardless — so the request is gone and the game is in
  neither file. The row would sit in 'approved' forever, and since
  /api/ingest/known counts 'approved' as known, no future sweep would ever
  offer that appid again. No UI action could reach it either: 'approved' is not
  in DECIDABLE. Approvals unobserved after 12h now age out to 'failed', which
  is decidable, and re-approving re-commits the link. 12h, not less: ingest-new
  shares the data-write concurrency group with ~115-minute jobs.
- removed_games.jsonl is unpruned history going back to March. Matching on
  appid alone marked a fresh approval 'failed' on the strength of a months-old
  entry, so a game that stopped being free and later became free again could
  never be re-added. Now requires removed_at > decided_at.
- 'failed' is outside uq_queue_open_appid, so a failed row can coexist with a
  new pending row for the same appid. Approving both violated the index inside
  a D1 batch AFTER the commit had landed. Rival open rows are now stood down in
  the same batch, before the promotion, and a desync is reported rather than
  swallowed.
- appendLinks deduplicates its input; approving two rows sharing an appid wrote
  the link twice.
- A no-op approval returned the branch head as its commit sha, so commit_jobs
  and audit_log attributed an unrelated commit to the approval.
- "Select all on this page" ignored the active filter: filtering to one game
  and ticking it selected all 60 loaded rows, 59 of them invisible, and the
  next click would have approved them.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 22:37:57 +07:00
poli0981andClaude Opus 5 ed30c5dafd fix(worker): scope Access AUDs per route instead of pinning a token name
`wrangler tail` settled what Cloudflare does not document: a service token's
identity arrives as its opaque Client ID —

  ingest: principal not allowed { got: 'a5d1053e...access',
                                  expected: 'f2p-discovery' }

— not its friendly name. The obvious fix was to paste that Client ID into
INGEST_SERVICE_PRINCIPAL, but that publishes half of a credential pair in a
public repo to shore up a check that was the weaker half of the design anyway.

The real defect is that ACCESS_AUD was ONE pooled list. verifyAccessJwt accepted
any AUD in it for any route, so the three credentials were interchangeable at
the JWT layer: an admin session satisfied /api/ingest/*, and the unattended
discovery token satisfied /api/admin/* — which holds the GitHub App credential
that can write to this repository. The name pin existed only to paper over that,
and a string comparison is a poor substitute for not accepting the token at all.

Now verifyAccessJwt takes the AUDs valid FOR THAT ROUTE:

  ACCESS_AUD_ADMIN   /admin, /api/admin/*    (email policies)
  ACCESS_AUD_INGEST  /api/ingest/*           (Service Auth, f2p-discovery)

A token minted for the wrong application now fails signature verification
rather than being caught downstream, so credential crossing is structurally
impossible instead of merely checked for. A second guard rejects the wrong
credential CLASS per route — service tokens are unattended and must never drive
admin; a human session must never drive ingest.

Neither AUD is a secret: any Access-covered path 302s to a login URL carrying
its own AUD as the `kid=` parameter, readable with an unauthenticated curl.
That is how both were obtained, and it is why they can live in the repo while
the Client ID should not.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 19:51:38 +07:00
poli0981andClaude Opus 5 86061611a9 docs(admin): distinguish the three Access setup failures
All three present as "the endpoint is broken" and each has a different fix.
Cloudflare documents the Service Auth requirement explicitly; the AUD
allowlist and the principal pin are this repo's own additions and were
undocumented.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 19:21:14 +07:00
poli0981andClaude Opus 5 f1e3d6c1bc fix(worker): log the rejected ingest principal, accept either token spelling
The pin compared the JWT's `common_name` against the service token's friendly
name, but Cloudflare documents neither what `common_name` holds for a service
token nor how to find out — the friendly name and the Client ID are
indistinguishable from the Worker's side. A wrong guess 404s a correctly
configured caller, with the same bare 404 that means "no Access application
covers this path", so there is nothing to debug from.

Two changes, neither of which widens what is trusted:

- INGEST_SERVICE_PRINCIPAL is now comma-separated, so both spellings of the
  SAME token can be pinned rather than betting on one. The credential still has
  to be a service token and still has to be that token.
- A rejection now logs the identity Access actually supplied, so `wrangler
  tail` answers the question instead of trial and error.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 19:20:57 +07:00
poli0981andClaude Opus 5 234c34b81f fix(discovery): report Access refusals instead of a content-type error
`urlopen` follows redirects, so an Access login page arrived as HTTP 200
text/html and the script reported "expected JSON, got text/html" — which reads
as a broken endpoint when the real fact is that Access refused the credential.

Redirects are now surfaced rather than followed, and an Access login URL is
decoded from its own `meta` JWT, so the failure states what Access decided:

  Cloudflare Access redirected to its LOGIN PAGE instead of accepting the
  service token [aud=bd54655abb62... service_token_status=False
  auth_status=NONE].

That separates the three failures that previously looked alike:
  404, no redirect        no Access application covers the path
  302 to login page       application exists, policy refuses service tokens
  aud mismatch (in tail)  application exists, ACCESS_AUD is stale

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 19:18:42 +07:00
poli0981andClaude Opus 5 e9d09a829f feat(worker): allow the /api/ingest Access application's AUD
Third Access application, third AUD. ACCESS_AUD is an allowlist the Worker
checks against the token's `aud` claim, so the application alone was not
enough — requests through it would have been refused with `access: aud
mismatch`, a failure that appears only once the application starts working and
reads as an unrelated bug.

Also moves the ACCESS_AUD comment back above ACCESS_AUD (it had drifted above
INGEST_SERVICE_PRINCIPAL) and records which tag belongs to which application,
plus how to read a tag off the Access login redirect without the dashboard.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 19:14:23 +07:00
poli0981andClaude Opus 5 3f9447711d fix(repo): close .gitignore gaps that would leak credentials, untrack 3 files
You spotted .wrangler cache in the repo. It was not a one-off: the root
.gitignore had no .wrangler rule at all (only web/.gitignore did), so anything
run with wrangler from the REPO ROOT rather than web/ lands unignored. That is
how .wrangler/cache/wrangler-account.json — Cloudflare account id and account
email — reached a public repo.

Auditing outward from that found three more credential shapes with no rule,
all of which this project's own docs tell you to create:

- .dev.vars / .dev.vars.*  `wrangler dev` reads GH_APP_PRIVATE_KEY from here,
  and the PEM is INLINE, so the existing *.pem and *.key rules never see it.
  That App can commit to this repo. Highest-consequence gap of the three.
- *.jks / *.keystore / *.p12 / *.pfx  web/src-tauri/TAURI.md walks you through
  `keytool -genkeypair -keystore f2p-tracker-release.jks` using a RELATIVE path
  inside gen/android/, and reassures you keystore.properties is ignored — while
  the keystore itself was covered by nothing. Leak it and Android signing is
  compromised; lose it and the app can never be updated.
- .env.production / .env.development matched none of .env, .env.local or
  .env.*.local.

Two rules were silently hiding real source, verified with check-ignore:

- `env/` and `ENV/` are unanchored Python-virtualenv rules, so they matched
  web/worker/env/ at ANY depth — Worker source would vanish from `git add .`.
  (On this Windows checkout core.ignorecase makes ENV/ match env/ as well.)
- `[Nn]otes.md` matched docs/notes.md and docs/i18n/*/notes.md, the likeliest
  filename for real documentation in a repo whose output is markdown.
Both anchored to the repo root. `build/`, `dist/` and the one-off script rules
anchored for the same reason; web/dist stays covered by web/.gitignore.

Two rules did not do what their comments claimed:

- `*.log` matches scripts/dead_games.log, which mark-dead-games.yml explicitly
  stages and mark_dead_games.py appends to. It survives only because ignore
  rules do not apply to already-tracked files — rename or recreate it once and
  it disappears with no error. Now an explicit negation with the reason.
- `.vscode/` excludes the DIRECTORY, and git will not descend into an excluded
  directory, so the four `!.vscode/*.json` negations under it were dead code.
  Changed to `.vscode/*` so the exceptions actually apply.

Untracked (files left on disk, none referenced by any build):
- .wrangler/cache/wrangler-account.json  account id + email, the reported file
- web/src-tauri/.tauri-signing.key.pub   minisign F6E36504EAE8E3A2, which is
  NOT the updater key in tauri.conf.json (9F39774AE5453C53). A stale pre-
  rotation public key that web/src-tauri/.gitignore already forbids.
- .idea/.gitignore                       tracked despite the .idea/ rule

Verified: 21 check-ignore assertions both ways; the index delta is exactly
those three deletions (386 -> 383 files); no remaining tracked file is matched
by any ignore rule; nothing untracked is left unignored.

Also documents in docs/ADMIN.md that every new Access application needs its AUD
appended to ACCESS_AUD — omitted before, and it fails only after the
application starts working, which makes it look like an unrelated bug.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 19:03:36 +07:00
poli0981andClaude Opus 5 fc438042d4 fix(discovery): make --dry-run actually exercise the Access token
docs/ADMIN.md offers `gh workflow run "Discover New Games" -f dry_run=true` as
the check to run after setting up the service token. It was not one. Both the
/api/ingest/ping and /api/ingest/known calls sat behind `if not args.dry_run`,
so a dry run exercised Steam, the search parser and the filters — everything
that was already working — and never touched the credential, which is the only
new and only fragile part. A dry run against a completely wrong token passed.

Both calls are read-only, so running them under --dry-run keeps it dry.
Credentials absent (a local dry run) now says so instead of silently skipping.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 18:43:16 +07:00
poli0981andClaude Opus 5 d1da623fd9 fix(deps): patch the sharp advisory via override (GHSA, high)
sharp 0.35.2 reaches the tree only as a transitive dependency of
wrangler -> miniflare, so it is build-time only and never ships in dist/.
It still counts as an open high alert on the default branch, and the alert is
what people act on.

`npm update sharp` cannot move it: miniflare pins an exact "sharp": "0.35.2",
so the range admits nothing else. An override is the only lever short of
waiting for a miniflare release.

The 311-line lockfile diff is sharp's ~30 platform-specific @img/sharp-*
packages plus the @emnapi/@napi-rs WASM fallback runtime its wasm32 build
depends on -- nothing outside sharp's own subtree changes.

Verified: npm install clean, typecheck, build, and `wrangler deploy --dry-run`
all pass; `npm audit --audit-level=high` reports 0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 18:22:57 +07:00
poli0981andClaude Opus 5 bb7c5f861d fix(ci): backfill workflow was an invalid file — expression inside a comment
Actions evaluates ${{ }} anywhere in the workflow file, shell comments in a
`run:` block included. A comment explaining why an expression fallback was the
wrong tool here quoted the rejected form verbatim, and the quoted contexts do
not exist — so the whole file failed to parse and every push produced a failed
run with no jobs.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 18:20:00 +07:00
poli0981andClaude Opus 5 a39ef5bf65 fix(ci): stop ingest-from-issue dropping requests and misreporting outcomes
Three defects on the same path, all of which fail silently.

1. A queued request could vanish. The only commit came AFTER
   `python scripts/ingest_new.py`, so a transient Steam failure aborted the job
   with the appended line living nowhere but the runner's disk. Nothing was
   committed, nothing retried, and the reporting step never ran to say so. The
   queue entry is now committed BEFORE the ingest is attempted, so a failure
   leaves a durable request instead of nothing.

2. The issue was answered "Game added!" for games that were not added. The
   check was `temp_info.jsonl === ''`, but clear_temp() empties that file at
   the end of every ingest_new.py run - including one where every entry was
   rejected as duplicate, dead, or unreachable. It now asks the dataset, and
   distinguishes "added" from "already in the catalogue" by snapshotting which
   appids were present before the run.

3. The reporting step had no `if: always()`, so it only ever ran on the happy
   path - the one case that needed no explanation.

Also gives `Ingest New Game Links` a 3-hourly schedule. This is orphan
recovery, not polling: `data-write` keeps at most ONE run pending and cancels
the older one, so an ingest queued behind a ~115-minute data job is evicted the
moment any other data-write workflow queues, and nothing retries it. Re-running
on a clear file is free - ingest_new.py returns immediately and
`git diff --staged --quiet` skips the commit - so it is idempotent by
construction, and it is what makes fix 1's "will be retried" true.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 18:18:11 +07:00
poli0981andClaude Opus 5 bb99685dce feat(ingest): automated discovery — Worker endpoint, daily sweep, backfill
The repo had no code that could find a new game. update_data.py only enriches
records that already exist and ingest_new.py only reads a file a human filled
in, so "surface new releases within a day" needed a producer, not rewiring.

Three pieces, split so that discovery is automated and publication is not:

  /api/ingest/*      service-token-authenticated producer surface. Writes rows
                     with status='pending' and can do nothing else - it cannot
                     approve, commit, or reach the repository.
  discover_new.py    daily. Walks store search newest-first, stops after two
                     fully-known pages.
  backfill_discover  TEMPORARY. Sweeps one release window at a time to close
                     the historical gap, then gets deleted.

Measured today: Steam lists 16,668 free games under the catalogue's own
filters; data/ holds 3,424.

The backfill locates a window by BINARY SEARCH over search offsets rather than
walking from page 0. The store sort is Released_DESC, so offset is the date
axis and page_date() is monotonic - about 8 fetches to reach a 2024 window
instead of 90. Verified against live Steam: 2025Q4 located at page 21 in 7
probes.

Both scripts run under `permissions: contents: read` plus a grep step that
fails the run if either references save_main/save_jsonl/clear_temp/fetch_full.
The permission alone would block a push; the grep names the reason, which a
403 from git does not.

Fixes found while building this:

- _RE_RELEASED required a `col ` prefix the live markup does not have
  (`<div class="search_released responsive_secondrow">`), so every search row
  came back with an empty date. The cheap "Coming soon" skip therefore never
  fired and each such title cost a full appdetails call to reject.
- Game names are publisher-controlled and routinely non-Latin. print() of one
  raised UnicodeEncodeError on a cp1252 console, killing the sweep after every
  Steam request had already been paid for.

The two Access credentials are pinned apart on both sides: verifyAccessJwt
accepts any configured AUD, so without an explicit principal check an admin
session would satisfy /api/ingest/* and - far worse - the ingest token would
satisfy /api/admin/*.

Neither workflow can run until a Cloudflare Access service token named
`f2p-discovery` exists and its credentials are repository secrets; they fail
loudly rather than skipping, and docs/ADMIN.md §7 has the setup.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 18:17:32 +07:00
poli0981andClaude Opus 5 c4805065db fix: stop two live paths from silently destroying the ingest queue
Both found while designing the admin write path, both already in production,
and both lose data with no error anywhere.

ingest-from-issue.yml overwrote scripts/temp_info.jsonl with fs.writeFileSync.
That file is a shared queue with more than one producer — the Telegram bot
appends to it, and the admin Worker is about to — so a single [add-game] issue
destroyed every queued entry not yet consumed. The diff just showed a cleared
file. It now appends, and validates that each line of the issue's json block is
one complete JSON object before writing, because a pretty-printed block would
trip the second bug below.

load_jsonl wrapped its entire read loop in one try, so the first malformed line
ended the read and returned only the lines before it. ingest_new.py then
processed that partial list and called clear_temp(), truncating the file and
deleting every unread line after the bad one. A bad line is now skipped and
reported with its line number; only an OSError aborts the read.

The logging in that handler is deliberately ASCII. The first version used the
same warning glyph as the surrounding code and raised UnicodeEncodeError on a
cp1252 console — from inside the except block, which escaped the handler and
aborted the whole read, reintroducing exactly the loss being fixed. Logging in
an error path must not be able to throw.

Verified rather than assumed: the generated workflow JS passes node --check,
appending preserves a pre-existing queue entry, and load_jsonl now returns both
good lines from a file whose middle line is garbage.

Also saves the four design and adversarial-review documents behind this work to
docs/plan/.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 17:58:11 +07:00
poli0981andClaude Opus 5 3a0ba347cc fix(worker): accept every Access application's AUD, not just one
/api/admin/health returned 404 to an authenticated admin. Access had
authenticated the request correctly; the Worker then rejected the token.

Each Cloudflare Access application has its own AUD tag, and this Worker sits
behind two — one covering /admin, one covering /api/admin/*. ACCESS_AUD held
only the first, so tokens minted for the API application failed the aud check.
The page worked and every API call failed, which is a confusing shape for the
same underlying cause:

  /admin            -> aud ca93cf2c...  (configured)
  /api/admin/health -> aud a15d6e93...  (not configured)

ACCESS_AUD is now a comma-separated list and verification passes if the token
carries any known tag. The check itself stays — dropping it would accept a
token minted for any other application in the same Access organisation.

Also makes this class of failure diagnosable. The client response is
deliberately opaque, and returning an identical 404 for "token rejected" and
"no such route" is what made a configuration problem look like a routing bug.
Both paths now log to Workers Logs — the aud mismatch reports what it got
versus what it allows, and a failed verification reports whether the request
even carried a token. Nothing extra is revealed to the caller.

Confirmed separately from the installation screenshot: the GitHub App is
installed on this repository with metadata read and contents read/write, so
the App itself was never the problem.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 17:16:20 +07:00
poli0981andClaude Opus 5 c6f969f955 feat(worker): admin foundation — Access verification, GitHub App tokens, D1 schema
The prerequisites were already in place: the GitHub App secrets are set on the
Worker, and Cloudflare Access gates /admin and /api/admin/*. This adds the
Worker side.

AUTHENTICATION HAPPENS ONCE, IN THE ROUTER. worker/index.ts verifies the Access
JWT before dispatching to any admin handler, rather than leaving each handler
to remember. Access already gates these paths at the edge, so this looks
redundant — it is not. The path is not the security boundary; the credential
behind it is. A misconfigured route, a preview hostname, or a future refactor
would otherwise deliver an unauthenticated request to code holding
repository-write access.

Verification checks the signature against the team JWKS and, critically, the
`aud` claim. Without the aud check any token minted for any other application
in the same Access organisation would be accepted here. Issuer, exp and nbf are
checked too, and service tokens (which carry `common_name` rather than `email`)
are recognised as machine callers.

Unauthenticated admin requests get 404, not 401 — they learn nothing about what
exists, and Access has already redirected real humans to a login. /admin also
answers explicitly rather than falling through to the SPA handler, which would
serve the PUBLIC app shell at an admin URL.

GITHUB APP TOKENS. The App's private key never expires while the tokens it
mints last about an hour — the point of using an App rather than a PAT, given
a silently expired PAT stalled this pipeline for a month. One trap handled in
code: GitHub issues PKCS#1 keys ("BEGIN RSA PRIVATE KEY") and Web Crypto
imports only PKCS#8, so the Worker wraps the DER itself instead of leaving an
openssl step in a runbook for someone to skip. The app JWT backdates `iat` by
60s because Workers' clock can sit slightly ahead of GitHub's.

D1 SCHEMA (migration 0001). ingest_queue with a partial unique index allowing
at most one OPEN row per appid; ingest_decisions as long-term memory so a
rejected appid does not reappear in tomorrow's sweep; commit_jobs, written
before a commit is attempted so a crash mid-flight leaves evidence; and
audit_log, which records the acting Access identity and the target and
deliberately nothing about visitors — no IP, no User-Agent, no country. That
matches what docs/PRIVACY_POLICY.md states; the two must stay agreed.

Game records are NOT in D1. data/*.jsonl in Git remains the source of truth,
which is what makes losing this database survivable.

Endpoints are read-only for now: /me, /health, /queue, /audit. approve/reject
write to Git and are deliberately absent rather than half-working. /health
reports D1 and GitHub separately so a failure names itself, and its GitHub
probe exercises the private key, the installation and its permissions in one
call.

wrangler.jsonc also gains migrations_dir, which was missing — wrangler looked
in web/migrations and reported "no migrations present" while the file sat in
worker/migrations.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 16:45:23 +07:00
poli0981andClaude Opus 5 96b2d2d69d fix: correct two stale claims that a wildcard add swept in
The previous commit staged these with `git add -A`; both had been left
uncommitted because they were wrong, so correct them rather than carry them.

username.txt said the Telegram QR codes were untracked. They are tracked —
assets/qr/telegram-bot.png and assets/qr/telegram-user.png — and CONTRIBUTING.md
and AUTHORS.md already link to those paths.

.gitignore carried a block ignoring app/dist, app/release and friends under the
heading "F2P Tracker desktop app (Electron + Vite)". There is no app/ directory
in this repo and the desktop shell is Tauri 2 with a Rust backend, so the block
ignored nothing and described the wrong technology. Replaced with the paths
Tauri actually produces. Verified the new rules match no already-tracked file.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 16:09:04 +07:00
poli0981andClaude Opus 5 5ab4f27347 docs: split the licence, correct the legal docs, add deployment and admin guides
The docs had drifted badly from the code. This makes them true.

LICENCE SPLIT. Code stays MIT; the dataset moves to CC BY 4.0 in a new
LICENSE-DATA, which is explicit about what the project cannot license: the
`description` field is the publisher's own store blurb stored verbatim (median
213 characters), `header_image` is a URL to publisher artwork, and game names
are trademarks used nominatively. Blanket-MIT over that material was a claim
the project was never entitled to make. Facts — player counts, review
percentages, platform support — are noted as unownable; the CC BY grant covers
the compilation and the project's own derived fields.

PRIVACY POLICY, rewritten rather than patched. The previous one said "no
backend, no server-side log, no cookies, no server other than GitHub's CDN".
Every clause of that is now false: the site runs on a Cloudflare Worker that
processes IP and User-Agent and keeps operational logs. It also documents the
one honest exception — the Activity page still calls api.github.com and loads
GitHub avatars from the browser, so GitHub sees a visitor's IP there while no
other page does — and lists every localStorage, IndexedDB and Cache Storage key
with why it exists.

SECURITY.md, rewritten. The old one claimed "no executable code, no
dependencies, no backend, no user data" and said there was no contact address,
while four other files publish one. It also told people to report
vulnerabilities in public issues. There is now a real scope (the Worker, the
proxies, D1, Actions secrets, the Tauri signing key), a private channel via
GitHub's vulnerability reporting, and specific things worth probing.

EULA corrected on two counts: it asserted a single MIT licence over everything,
and claimed there is "no installable software" despite the signed desktop and
Android builds. ToS and DISCLAIMER updated for the licence split, the new
domain, and the removal of in-browser editing and GPG signing — the disclaimer
described a signing flow that no longer exists.

README contradictions fixed: 1.2k games -> 3,424 across 5 shards not 2, 11
workflows -> 24, two scripts listed that were never in the tree, a TanStack
Table dependency the project does not use, and nine links to the old Pages URL.

New: docs/DEPLOYMENT.md (how a push becomes a deploy, the two wrangler.jsonc
fields that silently break it, and the stale-service-worker trap when verifying)
and docs/ADMIN.md (Cloudflare Access plus the GitHub App, with the exact
permission set — Contents write and Metadata only, and why Actions and
Workflows are deliberately withheld).

Two live fixes came out of writing this. GitHub Pages was serving a blank page:
it had the new index.html, which references assets at `/`, while Pages serves
under /free-steam-games-list/, so every asset 404'd — and deploy-pages.yml kept
redeploying it. That workflow now publishes a redirect that preserves the #/
fragment, since Pages cannot issue a 301. And CI pinned Python at 3.11, 3.12
and 3.14 across different workflows while the docs claimed 3.12 was pinned;
all fourteen references are now 3.12, which makes the claim true.

TERMS_VERSION 1 -> 2, so everyone re-consents. A privacy policy that now
discloses edge logging where it previously promised none is not a change to
apply silently.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 16:09:04 +07:00
github-actions[bot] be52b1df0e chore(data): mark dead games 2026-09-10 09:02:58 +00:00
poli0981andClaude Opus 5 bc4a1f2a2d feat(web): new palette, token-driven charts, and a charts index
Visual refresh, in three parts.

Palette. Replaces the stock shadcn slate/blue tokens with a deliberately
chosen set: a deeper, less saturated background, a brighter primary that reads
as its own colour rather than framework default, and a larger radius
(0.5 -> 0.625rem). Adds the semantic tokens the components had been
approximating with raw Tailwind classes — success, warning, info — plus
surface-2 and border-strong for elevation. Both themes get real values; the
light palette is no longer an afterthought.

Charts. They hardcoded roughly eighteen hex colours, so they ignored the theme
entirely and would have clashed with any palette change — and never responded
to the light/dark switch. A new chart-theme module resolves the CSS custom
properties at render time and supplies ECharts' default categorical palette
along with tooltip, text and grid colours. Colours that carry MEANING are
deliberately left alone: review-score green/amber/red and the platform brand
colours are data semantics, not decoration.

Information architecture. Eleven chart entries in the sidebar crowded out
everything else, and /charts merely redirected into /charts/genres, which hid
the other ten. The sidebar now has one Charts entry beside the leaderboards,
and /charts is a real index page describing each view. Both read from one
shared chart-nav list so they cannot drift apart.

Two subtitles were left describing removed features — Settings claimed
"Authentication, theme, and preferences" and Health advertised "maintenance
triggers". Both corrected in each locale.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 15:17:53 +07:00
poli0981andClaude Opus 5 64126ffa4c feat(web)!: remove sign-in and all editing; the site is read-only
The public app now offers viewing and interaction only — search, filter, sort,
charts, export — with no authentication surface at all. Editing moves behind
Cloudflare Access and a server-side GitHub App, which is the admin work that
follows; none of it belongs in a bundle every visitor downloads.

This deletes 32 files: the four auth panels, the auth and GPG stores, the
GitHub API client, OAuth device flow, the commit machinery (edits, git-data,
optimistic, verify-commit, jsonl-shard), the owner/commit hooks, the Add page,
the edit and bulk-edit drawers, DiffViewer, and the vendored openpgp copy.

The security argument is the main one. The old model kept a GitHub PAT *and* an
armored GPG private key in localStorage on a public origin, and gated write UI
purely client-side. Deleting it removes that exposure outright rather than
hardening it.

Surfaces that survive, with their auth dependencies severed:
- Activity keeps the commit feed, now fetched unauthenticated. Its "mine"
  filter is gone: with no signed-in identity there is no "me" to filter on.
- Health keeps the validation report; the workflow-dispatch buttons go, since
  triggering a run needs a write-scoped token.
- Settings keeps language and the introduction toggle.
- The games table loses its selection checkboxes, which existed only to feed
  bulk edit and delete.
- The Android update check drops its Authorization header; the release list is
  public and the anonymous rate limit is ample for a once-per-launch check.

Also removes openpgp, two Radix packages and @tauri-apps/plugin-http, now
unreferenced, plus the five i18n groups whose entire UI is gone (add, edit,
bulk, diff, verify — 102 keys per locale). Leaf-level i18n pruning was
deliberately NOT attempted: many keys are referenced dynamically, such as
nav entries via t(item.i18n), so a static sweep reports live keys as dead.

One trap worth recording: src/types/openpgp.d.ts carried the
vite-plugin-pwa triple-slash type references, despite its name having nothing
to do with them. Deleting it with the signing stack silently broke the types
for virtual:pwa-register/react. They now live in vite-env.d.ts.

Bundle effect: the precache drops from 1,992 KiB to 1,462 KiB across 53 rather
than 60 entries, and the 386 kB openpgp chunk is gone.

Primary locale is now English: index.html declares lang="en" and og:locale
en_US, with vi_VN as the alternate.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 15:11:10 +07:00
poli0981andClaude Opus 5 d387ccca64 fix(a11y): give the mobile navigation drawer an accessible name
Radix logged a console error — not a warning — every time the mobile drawer
opened: DialogContent requires a DialogTitle for screen reader users. The
drawer had none, because sheet.tsx never exported a SheetTitle at all. The
three Dialog-based drawers were already correct.

Adds SheetTitle and SheetDescription mirroring dialog.tsx, and gives
MobileSidebar an sr-only title so the drawer is announced without changing
what anyone sees. aria-describedby={undefined} declares the absent description
as deliberate, which is what silences the companion warning.

Verified with the drawer open: aria-labelledby resolves to "Navigation" and
the console is clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:53:16 +07:00
poli0981andClaude Opus 5 440fc54ae5 feat(web): first-run welcome page
A short introduction shown after the legal gate, never instead of it: the
consent gate still wraps the whole app, and /welcome is an ordinary route
inside it.

Content is deliberately limited to what someone needs before relying on the
list: what it is, the honest framing the project already takes in
docs/DISCLAIMER.md (inclusion is not a recommendation, the derived fields are
best-effort, no warranty), how often the data refreshes, three ways in, the
language switch, and the documents just accepted.

The seen-flag is versioned separately from f2p:legal_consent. They answer
different questions, and coupling them would re-run the introduction on every
legal edit, which reads as a factory reset. Settings gains a "show the
introduction again" action that clears the flag as well as navigating, so
leaving the page without pressing Continue does not silently re-arm it.

The page never blocks on the dataset: the count and last-updated date fill in
if useGames already has them and are simply absent otherwise, so first paint
does not wait on a network fetch. The count is run through formatNumber rather
than i18next's {{count}} — the raw form rendered "3424 games" two lines under a
topbar reading "3,424", and {{count}} additionally carries plural-selection
semantics that do not apply to a preformatted string.

Copy is written in both locales rather than English-only with a Vietnamese
fallback.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:49:13 +07:00
poli0981andClaude Opus 5 245fcd4b0b fix(web): restore npm run dev, pin wrangler, unbreak knip
Three problems, all introduced by the Cloudflare work in the previous commits
and all caught by the CI gate on its first real run.

1. `npm run dev` was broken. Moving the dataset and images onto /api/data/* and
   /img/* meant `vite dev` answered both with the SPA shell, since it serves
   index.html for any unmatched path. The dataset fetch then parsed HTML as
   JSON, threw, and React Query retried in a loop — over a thousand requests in
   one session — while every image resolved to text/html. A dev-server proxy to
   the deployed Worker restores real data and real images with HMR intact.
   Worker source itself still needs `npx wrangler dev`, which is noted inline.

2. `wrangler` was an unlisted binary. package.json scripts and web-ci.yml call
   `npx wrangler`, but it was never a dependency, so CI would have resolved an
   arbitrary version on every run. Pinned as a devDependency.

3. knip reported tailwindcss and tw-animate-css as unused because its project
   glob covered only ts/tsx, and both are reached solely through @import in
   src/index.css. Added CSS to the entry and project globs so those edges
   resolve, rather than suppressing the finding.

Worth recording: knip was added to CI on the claim that it exits 0. That was
measured before these changes and was wrong — `exports` and `types` are
warn-only in knip.json, but unused files, unused dependencies and unlisted
binaries are not, and it correctly failed on all three.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:48:49 +07:00
poli0981andClaude Opus 5 7729a19100 Merge branch 'upgrade/cloudflare-migration'
Stages 0-2 of the free-steam-games.win migration.

Stage 0 — unblocked a pipeline that had been dead since 2026-08-13 and closed
two live problems: `npm ci` failed on an echarts peer conflict, and
ingest-from-issue.yml let any user commit to main via an issue title.

Stage 1 — React 19, react-router 7, Tailwind 4, i18next 26, TypeScript 6.0.3,
quinn-proto. All 18 npm advisories and the Rust one are cleared; npm audit
reports zero at every severity.

Stage 2 — the Cloudflare Worker, wrangler.jsonc, and same-origin /api/data/*
and /img/* proxies. This also fixes what the domain was actually serving: an
unbuilt index.html pointing at /src/main.tsx, with the whole web/ source tree
publicly readable.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:38:43 +07:00
poli0981andClaude Opus 5 0988c8211c fix(cloudflare): deploy to the Worker that actually owns the domain
The Worker name was "f2p-tracker", but the Worker holding the
free-steam-games.win custom domain is named "free-steam-games-list" (created
today, has_assets: true, production environment). Deploying under the old name
would have created a second Worker with no domain attached and left the live
site serving the current broken build, with nothing obviously wrong in the
build logs to explain it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:32:10 +07:00
poli0981andClaude Opus 5 692fcb4731 feat(cloudflare): Worker, wrangler.jsonc, and same-origin data + image proxies
Adds the deployment config and Worker that Cloudflare Workers Builds runs.
There is deliberately no deploy workflow — pushing main is what deploys.

Context for the base-path change, which the plan had scheduled later: the
domain is already live and already broken. It currently serves the repo's
web/ directory unbuilt, so `/` returns an index.html pointing at
/src/main.tsx (TypeScript the browser cannot execute) and the whole source
tree is publicly readable. `assets.directory: "./dist"` plus `base: "/"` is
what fixes that, and neither is useful without the other, so they land here.

wrangler.jsonc:
- Lives in web/ because Workers Builds detects the package manager from a
  lockfile in its root directory, and there is no root package.json.
- workers_dev: false — a zone-scoped Access policy does not cover the
  workers.dev hostname, which would later expose /admin and the repo-write
  credential behind it on an unprotected origin.
- run_worker_first covers /api/*, /img/*, /admin and /admin/*. /img/* must be
  listed or images fall through to the SPA handler and return index.html as
  text/html; /admin must be listed or the SPA fallback serves the public shell
  where Access is expected. /assets/* is deliberately absent — routing hashed
  bundles through the Worker would bill every JS and CSS request.

/api/data/* proxies the dataset that stays canonical in Git, against an
anchored allowlist of exactly the three paths the app fetches. Proxying rather
than shipping data/ inside dist/ keeps the daily pipeline commits decoupled
from deploys: as build output, every data commit would force a full rebuild,
and if watch paths ever excluded data/ the site would serve a frozen dataset
with no error anywhere. index.json is sent no-cache because it carries
last_updated, the client's only cache-invalidation signal.

/img/* replaces the images.weserv.nl hop, so no visitor request reaches a
third party. It allowlists both Steam CDN hosts — akamai and fastly, the
latter being ~44% of records, which the old service-worker rule missed
entirely. Thumbnails prefer Steam's capsule asset and fall back to the header
when it does not exist (verified: 3,634 b vs 37,878 b on a cold appid, and the
hashed-path records fall back correctly). Transformations are OFF: they bill
separately from Workers Paid and Cloudflare has no spend cap, so real /img/*
volume gets measured first.

Also: tsconfig.worker.json, because tsconfig.json only includes ["src",
"vite.config.ts"] and the Worker would otherwise ship untyped; web-ci.yml now
runs both typechecks plus `wrangler deploy --dry-run`; 404.html is deleted as
not_found_handling replaces it; and index.html, robots.txt and sitemap.xml
stop declaring the GitHub Pages URL canonical now that this origin serves the
site.

Verified against a local `wrangler dev`: static assets, SPA fallback, all
three data paths with correct cache headers, all three image variants, and
404s for unknown variants, non-numeric appids, non-allowlisted data paths and
encoded traversal attempts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:27:48 +07:00
poli0981andClaude Opus 5 eae8f6354d fix: detect MIME-type chunk failures, install pinned Python deps everywhere
isChunkLoadError only matched the three "failed to fetch dynamically imported
module" style messages. Those cover a 404 on a stale chunk, but not what a
host with an SPA fallback returns: a request for a deleted hashed chunk is
answered with index.html at HTTP 200 and Content-Type: text/html, so the
browser rejects it on MIME type instead. The message looks nothing like a
fetch failure, so the reload-once recovery would silently stop working the
moment the site moves behind Cloudflare's not_found_handling. Added the
"failed to load module script" / "expected a javascript module script"
patterns and lifted the regex to a named constant.

Python installs now go through requirements.txt at all 11 sites — nine
bash/*.sh scripts and the two inline workflow steps — instead of a bare
`pip install requests`. The bare install silently ignored the urllib3 pin,
so CI was resolving a dependency the requirements file was trying to
constrain. mark-dead-games.yml already did this correctly.

requirements.txt and requirements-dev.txt move from `>=x,<y` ranges to exact
`==` pins: the pipeline should install identical versions on every run, and
Dependabot does not raise PRs for range-specified dependencies, so the new
pip ecosystem entry in dependabot.yml would otherwise have had nothing to do.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:06:50 +07:00
poli0981andClaude Opus 5 f99784910c build(deps): TypeScript 6.0.3
typescript 5.9.3 -> 6.0.3.

Deliberately not 7.0.2, which is the current `latest` tag. TS 7 is the native
Go rewrite rather than an incremental release, so it is a much larger change
than a version bump implies and is worth landing on its own once the rest of
the migration has settled. 6.0.3 is the newest stable of the JS-based line.

TS 6 deprecates `baseUrl` (and 7 removes it), which surfaced as an error
rather than a warning. Rather than silencing it with `ignoreDeprecations`,
`baseUrl` is simply dropped: since TS 5 the `paths` mapping resolves relative
to tsconfig.json, so the `@/*` alias keeps working and continues to mirror the
Vite `resolve.alias` entry. Worth noting the alias currently has zero call
sites in src/ — it is kept only so the two configs stay in agreement.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:05:22 +07:00
poli0981andClaude Opus 5 6d4604cb60 build(deps): Tailwind 4 — mechanical migration, tokens byte-for-byte
tailwindcss 3.4.19 -> 4.3.3, plus @tailwindcss/vite, tw-animate-css and
tailwind-merge 3.6.0. Removes tailwindcss-animate, autoprefixer and postcss
as direct dependencies, along with tailwind.config.ts and postcss.config.js.

Deliberately mechanical: the 17 HSL channel triples in :root/.dark are copied
across unchanged, so this migration is visual-neutral and revertable on its
own. The palette rework is a separate change and does not belong here.

Config moves from JS to CSS:
- `darkMode: ["class"]` becomes `@custom-variant dark (&:where(.dark, .dark *))`
- `theme.extend` becomes `@theme inline`. `inline` matters: it keeps opacity
  modifiers such as the sidebar's `bg-primary/15` resolving through
  color-mix(), and lets .dark re-resolve per element.
- Tailwind runs as a Vite plugin rather than a PostCSS one; @tailwindcss/vite
  handles prefixing, so autoprefixer is redundant.

Two v4 removals needed real handling rather than a rename:
- `theme.container` config is gone. The replacement `@utility container`
  reproduces the previous output exactly — centred, 1rem gutter, and the same
  breakpoint steps with 2xl pinned to 1400px — rather than the fluid version,
  so container widths between breakpoints do not shift.
- `max-w-screen-*` no longer exists. Layout.tsx's `max-w-screen-2xl` was
  already inert (1536px against the container's own 1400px cap), so dropping
  it changes nothing.

tailwindcss-animate is v3-only; tw-animate-css supplies the animate-in /
slide-in-from-* utilities the Radix dialog, sheet and popover depend on.
command-palette.css needed no changes — it is plain CSS reading the same
custom properties.

Verified in the browser rather than only via a green build: dark tokens, card
borders and radius, the KPI grid, the container width, the mobile Sheet's
slide-in animation, and the active nav item's bg-primary/15 tint all render as
before.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 14:03:45 +07:00
poli0981andClaude Opus 5 fe3fff58af build(deps): i18next 26 + react-i18next 17
i18next 23.16.8 -> 26.4.2, react-i18next 15.7.4 -> 17.0.13,
i18next-browser-languagedetector 8.0.0 -> 8.2.1.

react-i18next 17 is required rather than optional: its peer range is
`i18next >= 26.2.0`, so the two majors move together. The detector stays on
v8, which already supports i18next 26.

No source changes were needed. src/i18n/index.ts uses only APIs that are
stable across these majors — init, hasResourceBundle, addResourceBundle,
changeLanguage, resolvedLanguage, and the languageChanged event — and the
per-locale lazy-loading scheme around them is untouched.

Verified the path that actually matters, since a broken switch would be
invisible to typecheck: switching to Vietnamese loads the lazily-imported
vi.json bundle, persists `f2p:lang`, updates `<html lang>` via the
languageChanged listener, and re-renders every string (page titles, filters,
table chrome). English round-trips the same way.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 13:59:35 +07:00
poli0981andClaude Opus 5 0b1bac26bb build(deps): React 19.3.0
react + react-dom 18.3.1 -> 19.3.0, @types/react + @types/react-dom -> 19.3.0.

The removed-API surface was checked before upgrading and this codebase touches
none of it: no defaultProps or propTypes on function components, no
ReactDOM.render/hydrate, no findDOMNode, and no string refs (an initial grep
for `ref="` matched only `href="`). forwardRef is deprecated in 19 but not
removed, so the nine shadcn primitives in components/ui/ are unaffected.

Every React-dependent dependency already declares a v19 peer range — the Radix
primitives, @tanstack/react-query and react-virtual, cmdk 1.1.1, sonner 1.7.4,
react-i18next and echarts-for-react — so nothing else needed bumping and
`npm ls react` reports no invalid peers.

One real type break, fixed at the definition rather than the call site:
React 19 types make useRef<T>(null) return RefObject<T | null>, so Layout's
mainRef no longer satisfied BackToTop's `scrollRef: RefObject<HTMLElement>`.
BackToTop already dereferences defensively (`scrollRef.current?.scrollTo`), so
widening the prop to `RefObject<HTMLElement | null>` only makes the type match
the behaviour that was always there.

Verified at runtime under StrictMode, which is where the double-invoke risk
sits (the i18n bootstrap in main.tsx and the sessionStorage chunk-reload flag
in lib/lazy.ts): dashboard, games + detail drawer, health, about, the chart
pages and the Ctrl+K command palette all render, and a fresh load logs no
errors.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 13:55:13 +07:00
poli0981andClaude Opus 5 669d89f2eb build(deps): react-router 7 and quinn-proto 0.11.17 — audit now clean
react-router-dom 6.30.4 -> 7.18.3, with no source changes required. The app
uses only the declarative API (Routes/Route/Link/NavLink/useNavigate/
useLocation/useParams/useSearchParams/Outlet) — no data router, no loaders or
actions — and v7 keeps react-router-dom as a re-export, so every import site
is unchanged.

The two v7 behaviour changes were checked rather than assumed:
- v7_relativeSplatPath is a no-op here: every `to=` in src/ is absolute, so
  there are no relative links inside the splat route to re-resolve.
- v7_startTransition was verified at runtime against the lazy routes, which
  are the part that could plausibly regress (lazyWithRetry + Suspense inside
  Layout). Games, Activity, Settings, the chart pages and the /games/:appid
  deep link all render, and a fresh page load logs no warnings or errors.

HashRouter is deliberately retained for now; the BrowserRouter switch is a
separate one-line change once the site is served by Cloudflare, so a routing
regression stays distinguishable from a dependency regression.

cargo update -p quinn-proto pulls 0.11.14 -> 0.11.17, clearing the remote
memory-exhaustion advisory. It arrives transitively via reqwest. cargo check
passes.

`npm audit` now reports 0 vulnerabilities at every severity, closing the last
of the 18 npm advisories alongside the Rust one.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 13:51:31 +07:00
poli0981andClaude Opus 5 8f3f3ebeff docs: record project invariants and the migration design set
CLAUDE.md captures the load-bearing facts that are easy to violate and
expensive to discover: appid is derived from `link` rather than stored,
numeric-looking fields are formatted strings, MANUAL_FIELDS survive refetch,
shard assignment is unstable because save_main() re-chunks from scratch,
index.json.last_updated is the only cache-invalidation signal, and the
echarts theme trap above. Every claim was checked against the code.

docs/plan/ holds the seven design documents and three adversarial critiques
behind the Cloudflare migration, including the wrangler layout adjudication,
the D1 schema, and the 67-row documentation contradiction table.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 13:46:54 +07:00
poli0981andClaude Opus 5 6f5f2e1c8f fix(web): stop index.json losing keys, remove the force-push param
bumpedIndexFile() rebuilt data/index.json from a hardcoded four-key list and
each file entry from {name, count}, so every other key was deleted on write —
despite the docstring claiming "Other fields stay as the pipeline left them".
Harmless today only because nothing else writes keys there yet; the moment
licence metadata or a content hash is added, one routine edit through the UI
would strip it and the site would break with no error. Switched to spreading,
which is a prerequisite for the planned index.json additions.

updateBranchRef() carried an unused `force` parameter wired straight into the
update-ref body. No call site passes it, and a force push here would erase
whatever the data pipeline committed in between — the existing
RefAdvancedError retry is the correct response to a moved ref. Removed the
parameter so it cannot be reached for later.

jsonl-parser.ts now validates the message shape. CodeQL flags this handler as
js/missing-origin-check, but an origin check is the wrong fix: it is a
dedicated module worker, so the only sender is the document that constructed
it and MessageEvent.origin is the empty string. Validating {id, text} is the
hardening that actually applies — a malformed post now rejects the pending
promise instead of throwing unhandled inside the worker.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 13:46:53 +07:00
poli0981andClaude Opus 5 72d00c1014 fix(ci): drop the expired PAT, close an unauthenticated write path, land snapshots
The scheduled pipeline has been failing daily since 2026-08-13 (last successful
`Auto update` was e8b7d1b2). Root cause: `secrets.GH_TOKEN`, a PAT, expired.
Every workflow passing it to actions/checkout dies at fetch with exit 128.

No workflow actually needs a PAT. Each already declares
`permissions: {contents: write}`, so the built-in GITHUB_TOKEN has push rights —
proven by mark-dead-games.yml, the only green data workflow and the only one
with a bare checkout. Removed the `token:` input from all 12 sites. This also
ends the silent-expiry failure mode rather than rescheduling it a year out.

`workflow_run` triggers are unaffected: GITHUB_TOKEN suppression applies to
push/issues/release events, and update-daily.yml plus the three notify-*
workflows all key off workflow_run, which the Actions service emits on run
completion regardless of the checkout token.

Also in this commit:

- ingest-from-issue.yml gated on `author_association`. Without it, any user
  could open an issue titled [add-game] and have their JSON committed and
  pushed to main with `contents: write`. A title match is not an authorization
  check. Its `&&`/`||` commit chain is also parenthesised — left-associativity
  meant it pushed even when there was nothing staged.

- bot-ingest.yml's final step deleted. It referenced `secrets.BOT_TOKEN` while
  the rest of the file uses TELEGRAM_BOT_TOKEN, `cat`-ed a result.txt no step
  creates, ran under `if: always()`, and interpolated a secret straight into a
  shell command line. The Python step above it already does the same Telegram
  callback correctly. `secrets.BOT_TOKEN` is now unreferenced.

- The snapshot feature is committed. snapshot-daily.yml gains the
  `concurrency: {group: data-write}` guard every other data-writing workflow
  has — without it a 23:00 run can push against jobs that take ~2 hours. The
  `pip install requests` in bash/snapshot.sh is dropped: snapshot.py and
  scripts/core/* import only stdlib.

- New web-ci.yml. deploy-pages.yml was the only thing running `npm run
  typecheck`, so deleting it during the Cloudflare migration would leave the
  frontend unchecked. Uses a plain `npm ci` — the old `npm ci || npm install`
  fallback is what let the lockfile conflict above go unnoticed.

- New dependabot.yml. NOTE: an in-repo config replaces the one in repo
  settings and supersedes open PR #111. Groups security updates so the
  transitive backlog collapses into one PR instead of one per package.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 13:46:38 +07:00
poli0981andClaude Opus 5 e26fb92283 fix(web): unblock npm ci and stop echarts 6 silently blanking charts
Two coupled bugs — fixing either alone leaves the site broken.

1. `npm ci` has failed since 2026-08-13 with ERESOLVE: the lockfile resolves
   echarts 6.1.0 while echarts-wordcloud@2.1.0 declares a peer of echarts@^5.
   That peer is stale metadata, not a real incompatibility — every legacy API
   the plugin uses (extendSeriesModel, extendChartView, List, and the four
   helper.* functions) is still exported by echarts 6.1.0, verified against
   the runtime exports. Added an `overrides` entry pinned to the root echarts
   version via npm's `$echarts` syntax so it cannot drift.

2. With npm ci working, echarts 6 actually runs for the first time — and
   `theme="dark"` blanks every series. `echarts/core` registers no themes
   (only the full `echarts` bundle self-registers them); echarts 5 ignored an
   unknown theme name, echarts 6 drops all series rendering instead. Axes,
   grid and legend still paint, so charts look empty rather than broken and
   nothing is logged. Confirmed by bisect: removing the prop restores pie,
   bar, line and wordcloud immediately.

Dropping the theme regressed tooltips to echarts' light default, so the dark
tooltip styling it used to supply is now set explicitly — spread so per-chart
`formatter`/`trigger` still win.

Production was never exposed: the deploy for the echarts bump failed on this
same ERESOLVE, so the live site still serves the last pre-bump build.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 13:46:08 +07:00
github-actions[bot] dd6532eaec chore(data): mark dead games 2026-09-07 09:32:50 +00:00
github-actions[bot] b0c21f9320 chore(data): mark dead games 2026-09-03 09:04:02 +00:00
github-actions[bot] b0427af8f3 chore(data): mark dead games 2026-08-31 11:01:05 +00:00
github-actions[bot] b44378ff2f chore(data): mark dead games 2026-08-27 15:22:56 +00:00
github-actions[bot] fc99f5fd3c chore(data): mark dead games 2026-08-24 05:10:09 +00:00
github-actions[bot] fdf41e46ef chore(data): mark dead games 2026-08-20 05:03:06 +00:00
github-actions[bot] f34bc2650e chore(data): mark dead games 2026-08-17 05:06:31 +00:00
github-actions[bot] 24918f4a77 chore(data): mark dead games 2026-08-13 05:53:55 +00:00
dependabot[bot] c489a30a57 Bump serde_with in /web/src-tauri in the cargo group across 1 directory (#110) 2026-08-13 09:47:19 +07:00
dependabot[bot] 7663662cbb build(deps): bump echarts (#109) 2026-08-13 09:46:06 +07:00
github-actions[bot] fb733dc3c2 Update tables [2026-08-13] 2026-08-13 01:26:54 +00:00
github-actions[bot] e8b7d1b29e Auto update [2026-08-13] 2026-08-13 01:26:40 +00:00
github-actions[bot] da31c0ef45 Top online [2026-08-12 05:06] 2026-08-12 05:06:05 +00:00
github-actions[bot] 7d296e8c3c Update tables [2026-08-12] 2026-08-12 01:25:00 +00:00
github-actions[bot] cbbcab7b1e Auto update [2026-08-12] 2026-08-12 01:24:38 +00:00
github-actions[bot] ca1af0359c Update reviews [2026-08-11] 2026-08-11 08:58:18 +00:00
github-actions[bot] 666004a8b3 Dead link check [2026-08-11] 2026-08-11 06:54:29 +00:00
github-actions[bot] ae47c5c416 Auto update [2026-08-11] 2026-08-11 01:16:36 +00:00
github-actions[bot] f485a282bd Purge unhealthy [2026-08-10] 2026-08-10 08:00:21 +00:00
github-actions[bot] ce51e47cd7 chore(data): mark dead games 2026-08-10 05:53:45 +00:00
github-actions[bot] 958bfb739f Update tables [2026-08-10] 2026-08-10 01:18:52 +00:00
github-actions[bot] 4f078e45f1 Auto update [2026-08-10] 2026-08-10 01:18:40 +00:00
github-actions[bot] 9d30635665 Update reviews [2026-08-09] 2026-08-09 08:48:56 +00:00
github-actions[bot] 52b48a7948 Anti-cheat list [2026-08-09 06:47] 2026-08-09 06:47:10 +00:00
github-actions[bot] bdc3aaafd5 Top online [2026-08-09 04:37] 2026-08-09 04:37:44 +00:00
github-actions[bot] 6f2afe9ad7 Update tables [2026-08-09] 2026-08-09 01:16:55 +00:00
github-actions[bot] 5402de6938 Auto update [2026-08-09] 2026-08-09 01:16:40 +00:00
github-actions[bot] dcf12c12b2 Update tables [2026-08-08] 2026-08-08 01:12:12 +00:00
github-actions[bot] 59248281ee Auto update [2026-08-08] 2026-08-08 01:12:00 +00:00
github-actions[bot] b4ad6f7eae Update reviews [2026-08-07] 2026-08-07 09:08:20 +00:00
github-actions[bot] a75ec80e3d Top online [2026-08-07 05:14] 2026-08-07 05:14:13 +00:00
github-actions[bot] c927fa358f Auto update [2026-08-07] 2026-08-07 02:24:43 +00:00
github-actions[bot] 98cff9a7ef Dead link check [2026-08-06] 2026-08-06 08:19:53 +00:00
github-actions[bot] 360de7796e Update tables [2026-08-06] 2026-08-06 02:04:59 +00:00
github-actions[bot] 13b3058469 Auto update [2026-08-06] 2026-08-06 02:04:45 +00:00
github-actions[bot] 387500016f Update reviews [2026-08-05] 2026-08-05 10:27:50 +00:00
github-actions[bot] 8693067260 Top online [2026-08-05 06:05] 2026-08-05 06:05:51 +00:00
github-actions[bot] 2b55d998cf Auto update [2026-08-05] 2026-08-05 02:01:18 +00:00
github-actions[bot] b2fe7d154f Auto update [2026-08-04] 2026-08-04 02:02:01 +00:00
github-actions[bot] a66d3a4431 Purge unhealthy [2026-08-03] 2026-08-03 10:14:55 +00:00
github-actions[bot] cbb4dc66ba chore(data): mark dead games 2026-08-03 07:56:07 +00:00
github-actions[bot] c56bbdd74b Update tables [2026-08-03] 2026-08-03 02:21:52 +00:00
github-actions[bot] dbb623c0f2 Auto update [2026-08-03] 2026-08-03 02:21:39 +00:00
github-actions[bot] cd4c95e876 Anti-cheat list [2026-08-02 08:14] 2026-08-02 08:14:05 +00:00
github-actions[bot] 6650f9085f Top online [2026-08-02 06:17] 2026-08-02 06:17:44 +00:00
github-actions[bot] f48d5aa03a Update tables [2026-08-02] 2026-08-02 02:14:07 +00:00
github-actions[bot] 1742230b4d Auto update [2026-08-02] 2026-08-02 02:13:53 +00:00
github-actions[bot] 6293b763f9 Dead link check [2026-08-01] 2026-08-01 08:17:54 +00:00
github-actions[bot] 455995654a Update tables [2026-08-01] 2026-08-01 02:22:46 +00:00
github-actions[bot] 701a6f1eec Auto update [2026-08-01] 2026-08-01 02:22:20 +00:00
github-actions[bot] 6205f82a05 Update reviews [2026-07-31] 2026-07-31 10:43:35 +00:00
github-actions[bot] 2831aac801 Top online [2026-07-31 06:33] 2026-07-31 06:33:26 +00:00
github-actions[bot] 0413ad23b0 Auto update [2026-07-31] 2026-07-31 02:21:06 +00:00
github-actions[bot] 38d62e970f chore(data): mark dead games 2026-07-30 07:09:27 +00:00
github-actions[bot] 72ac2e5f56 Update tables [2026-07-30] 2026-07-30 01:56:33 +00:00
github-actions[bot] 238c8cfcbc Auto update [2026-07-30] 2026-07-30 01:56:20 +00:00
github-actions[bot] b4da4a73fe Update reviews [2026-07-29] 2026-07-29 10:32:55 +00:00
github-actions[bot] 67300f85c8 Top online [2026-07-29 06:12] 2026-07-29 06:12:45 +00:00
github-actions[bot] bb99b5ad04 Auto update [2026-07-29] 2026-07-29 02:06:22 +00:00
github-actions[bot] 15d4184eb1 Auto update [2026-07-28] 2026-07-28 02:03:20 +00:00
github-actions[bot] 13e9938a9d Purge unhealthy [2026-07-27] 2026-07-27 10:15:25 +00:00
github-actions[bot] 1f3886501f chore(data): mark dead games 2026-07-27 08:00:04 +00:00
github-actions[bot] 8f98ac14bb Update tables [2026-07-27] 2026-07-27 02:28:29 +00:00
github-actions[bot] d6808143ac Auto update [2026-07-27] 2026-07-27 02:28:15 +00:00
github-actions[bot] 90839a9b52 Dead link check [2026-07-26] 2026-07-26 08:26:10 +00:00
github-actions[bot] 2be980caac Top online [2026-07-26 06:26] 2026-07-26 06:26:06 +00:00
github-actions[bot] 5ed2961997 Update tables [2026-07-26] 2026-07-26 02:21:11 +00:00
github-actions[bot] 6e8ebfadbc Auto update [2026-07-26] 2026-07-26 02:20:58 +00:00
github-actions[bot] ceea4b6978 Update reviews [2026-07-25] 2026-07-25 09:59:38 +00:00
github-actions[bot] 717d4453bb Update tables [2026-07-25] 2026-07-25 02:10:33 +00:00
github-actions[bot] 6cf21522e5 Auto update [2026-07-25] 2026-07-25 02:10:18 +00:00
github-actions[bot] ddb33ad7fc Top online [2026-07-24 06:10] 2026-07-24 06:10:09 +00:00
github-actions[bot] af21085ef4 Update tables [2026-07-24] 2026-07-24 02:11:13 +00:00
github-actions[bot] 1c3a34ea43 Auto update [2026-07-24] 2026-07-24 02:11:01 +00:00
github-actions[bot] 6b4ac64623 Update reviews [2026-07-23] 2026-07-23 10:22:09 +00:00
github-actions[bot] 159fcab402 chore(data): mark dead games 2026-07-23 07:03:37 +00:00
github-actions[bot] 9d440de9d9 Update tables [2026-07-23] 2026-07-23 02:14:17 +00:00
github-actions[bot] f8a98b4ca3 Auto update [2026-07-23] 2026-07-23 02:14:05 +00:00
github-actions[bot] 509c2ce4bb Top online [2026-07-22 06:10] 2026-07-22 06:10:12 +00:00
github-actions[bot] c6e507cd40 Update tables [2026-07-22] 2026-07-22 02:08:07 +00:00
github-actions[bot] 5830c256a0 Auto update [2026-07-22] 2026-07-22 02:07:55 +00:00
github-actions[bot] 2122b06d54 Update reviews [2026-07-21] 2026-07-21 10:21:03 +00:00
github-actions[bot] 43654e1699 Dead link check [2026-07-21] 2026-07-21 08:18:45 +00:00
github-actions[bot] cf647e76d5 Auto update [2026-07-21] 2026-07-21 02:09:40 +00:00
github-actions[bot] cfe90d345d Purge unhealthy [2026-07-20] 2026-07-20 09:46:17 +00:00
github-actions[bot] 8054da8e54 chore(data): mark dead games 2026-07-20 07:39:41 +00:00
github-actions[bot] c49fbf6e46 Update tables [2026-07-20] 2026-07-20 02:31:40 +00:00
github-actions[bot] 1d0a35cb79 Auto update [2026-07-20] 2026-07-20 02:31:28 +00:00
github-actions[bot] 441ef818f8 Update reviews [2026-07-19] 2026-07-19 10:09:23 +00:00
github-actions[bot] bf035b72ac Anti-cheat list [2026-07-19 08:08] 2026-07-19 08:08:37 +00:00
github-actions[bot] e8878504e4 Top online [2026-07-19 06:12] 2026-07-19 06:12:41 +00:00
github-actions[bot] a3a5678688 Update tables [2026-07-19] 2026-07-19 02:10:57 +00:00
github-actions[bot] 4b702f0593 Auto update [2026-07-19] 2026-07-19 02:10:46 +00:00
github-actions[bot] 257752fd78 Update tables [2026-07-18] 2026-07-18 01:59:50 +00:00
github-actions[bot] b330baaef5 Auto update [2026-07-18] 2026-07-18 01:59:37 +00:00
github-actions[bot] 260c8598f7 Update reviews [2026-07-17] 2026-07-17 10:03:25 +00:00
github-actions[bot] 908633bddc Top online [2026-07-17 06:03] 2026-07-17 06:03:04 +00:00
github-actions[bot] 88d8590040 Auto update [2026-07-17] 2026-07-17 02:09:58 +00:00
github-actions[bot] 4ab087c612 Dead link check [2026-07-16] 2026-07-16 08:08:02 +00:00
github-actions[bot] b520ed6b22 Update tables [2026-07-16] 2026-07-16 02:07:16 +00:00
github-actions[bot] 60786bb066 Auto update [2026-07-16] 2026-07-16 02:07:06 +00:00
github-actions[bot] d8620da279 Update reviews [2026-07-15] 2026-07-15 10:02:21 +00:00
github-actions[bot] 14034f9c0e Top online [2026-07-15 05:51] 2026-07-15 05:51:29 +00:00
github-actions[bot] 65929bdd99 Auto update [2026-07-15] 2026-07-15 01:56:39 +00:00
github-actions[bot] 972cf6f5b7 Auto update [2026-07-14] 2026-07-14 02:00:15 +00:00
github-actions[bot] bbac3de95d Purge unhealthy [2026-07-13] 2026-07-13 10:03:19 +00:00
github-actions[bot] 72038c4139 chore(data): mark dead games 2026-07-13 07:47:22 +00:00
github-actions[bot] b3d46c6b89 Update tables [2026-07-13] 2026-07-13 02:14:54 +00:00
github-actions[bot] f7eb244de2 Auto update [2026-07-13] 2026-07-13 02:14:38 +00:00
github-actions[bot] ef4b4f3e0d Anti-cheat list [2026-07-12 08:09] 2026-07-12 08:09:15 +00:00
github-actions[bot] 4e8dd41a5b Top online [2026-07-12 06:18] 2026-07-12 06:18:05 +00:00
github-actions[bot] 9ceaf9b69a Auto update [2026-07-12] 2026-07-12 02:12:59 +00:00
github-actions[bot] 6d130ecf62 Dead link check [2026-07-11] 2026-07-11 08:03:26 +00:00
github-actions[bot] 1f84264d2d Update tables [2026-07-11] 2026-07-11 02:09:00 +00:00
github-actions[bot] a7d3b39721 Auto update [2026-07-11] 2026-07-11 02:08:45 +00:00
github-actions[bot] e1fdc638de Top online [2026-07-10 07:06] 2026-07-10 07:06:54 +00:00
github-actions[bot] aebfb477da Update tables [2026-07-10] 2026-07-10 02:32:19 +00:00
github-actions[bot] 4f2831a57b Auto update [2026-07-10] 2026-07-10 02:32:05 +00:00
github-actions[bot] 372ed918d7 Update reviews [2026-07-09] 2026-07-09 11:31:52 +00:00
github-actions[bot] 527a00db4a chore(data): mark dead games 2026-07-09 07:58:38 +00:00
github-actions[bot] 2d2c17ef37 Update tables [2026-07-09] 2026-07-09 02:30:04 +00:00
github-actions[bot] 17deee9719 Auto update [2026-07-09] 2026-07-09 02:29:52 +00:00
github-actions[bot] 65d06b20be Top online [2026-07-08 06:11] 2026-07-08 06:11:35 +00:00
github-actions[bot] 806c80f859 Update tables [2026-07-08] 2026-07-08 02:11:48 +00:00
github-actions[bot] 58580026ed Auto update [2026-07-08] 2026-07-08 02:11:30 +00:00
github-actions[bot] e7abbfd3de Update reviews [2026-07-07] 2026-07-07 11:34:44 +00:00
github-actions[bot] 9412ade22f Auto update [2026-07-07] 2026-07-07 02:38:04 +00:00
github-actions[bot] abf18f9264 chore(data): mark dead games 2026-07-06 09:19:06 +00:00
github-actions[bot] 3467dfb740 Dead link check [2026-07-06] 2026-07-06 07:22:36 +00:00
github-actions[bot] c5af139e03 Update tables [2026-07-06] 2026-07-06 02:42:16 +00:00
github-actions[bot] 493078dd18 Auto update [2026-07-06] 2026-07-06 02:42:00 +00:00
github-actions[bot] 0a32872dc3 Update reviews [2026-07-05] 2026-07-05 10:46:54 +00:00
github-actions[bot] 3dc581be79 Anti-cheat list [2026-07-05 07:06] 2026-07-05 07:06:45 +00:00
github-actions[bot] 228ec08504 Top online [2026-07-05 07:01] 2026-07-05 07:01:17 +00:00
github-actions[bot] 9cad8c51a6 Update tables [2026-07-05] 2026-07-05 02:37:42 +00:00
github-actions[bot] e4c593012d Auto update [2026-07-05] 2026-07-05 02:37:29 +00:00
github-actions[bot] 26947cd565 Update tables [2026-07-04] 2026-07-04 02:28:15 +00:00
github-actions[bot] b1fb7af55a Auto update [2026-07-04] 2026-07-04 02:28:00 +00:00
github-actions[bot] 220b598e1e Update reviews [2026-07-03] 2026-07-03 09:04:27 +00:00
github-actions[bot] d6d57f2378 Top online [2026-07-03 04:40] 2026-07-03 04:40:10 +00:00
github-actions[bot] d1280b8c24 Auto update [2026-07-03] 2026-07-03 02:30:15 +00:00
github-actions[bot] cbe41ac9e1 chore(data): mark dead games 2026-07-02 05:48:00 +00:00
github-actions[bot] 3a67287716 Update tables [2026-07-02] 2026-07-02 00:41:41 +00:00
github-actions[bot] e47f2a54fc Auto update [2026-07-02] 2026-07-02 00:41:27 +00:00
github-actions[bot] f31dfddb76 Update reviews [2026-07-01] 2026-07-01 10:01:54 +00:00
github-actions[bot] cd004f3d20 Dead link check [2026-07-01] 2026-07-01 07:28:12 +00:00
github-actions[bot] 233c96a15f Top online [2026-07-01 04:54] 2026-07-01 04:54:46 +00:00
github-actions[bot] 91d26934a6 Update tables [2026-07-01] 2026-07-01 00:44:16 +00:00
github-actions[bot] f036530902 Auto update [2026-07-01] 2026-07-01 00:44:03 +00:00
github-actions[bot] 7b2b7d9f7f Update tables [2026-06-30] 2026-06-30 16:34:08 +00:00
anon (hello) 7cd4712e79 Edit Kill The Super Duper Big Monster (data_005.jsonl) 2026-06-30 16:33:58 +00:00
github-actions[bot] 861284fcc4 Update tables [2026-06-30] 2026-06-30 16:32:55 +00:00
anon (hello) 59eaba91f8 Edit Swordsmith of Greyhaven (data_005.jsonl) 2026-06-30 16:32:43 +00:00
github-actions[bot] d23bc20e0a Update tables [2026-06-30] 2026-06-30 16:31:31 +00:00
anon (hello) 1773a61c36 Edit Cave Of Treats (data_005.jsonl) 2026-06-30 16:31:21 +00:00
anon (hello) 5e5903dae3 Edit DAL'T-4 (data_005.jsonl) 2026-06-30 16:29:24 +00:00
github-actions[bot] 499dc17fe8 Update tables [2026-06-30] 2026-06-30 16:27:44 +00:00
anon (hello) 0f2b969cb3 Bulk edit 2 games (1 shard) 2026-06-30 16:27:33 +00:00
github-actions[bot] 2452e91cd3 Update tables [2026-06-30] 2026-06-30 16:26:00 +00:00
anon (hello) eedf8df229 Edit Desktop Driller (data_005.jsonl) 2026-06-30 16:25:47 +00:00
github-actions[bot] 8963da0086 Update tables [2026-06-30] 2026-06-30 16:24:52 +00:00
anon (hello) 20bf7d4f1f Edit Pixel Rain (data_005.jsonl) 2026-06-30 16:24:40 +00:00
github-actions[bot] e5ffbe9ba7 Update tables [2026-06-30] 2026-06-30 16:22:38 +00:00
anon (hello) ddb92236e9 Edit Astropath (data_005.jsonl) 2026-06-30 16:22:27 +00:00
github-actions[bot] 15b6c37872 Update tables [2026-06-30] 2026-06-30 16:21:02 +00:00
anon (hello) bfc88db367 Edit Model Kit Shop Simulator: Prologue (data_005.jsonl) 2026-06-30 16:20:52 +00:00
github-actions[bot] 783c835dee Update tables [2026-06-30] 2026-06-30 16:19:21 +00:00
anon (hello) 720e8988cd Edit Wet Wealth (data_005.jsonl) 2026-06-30 16:19:11 +00:00
github-actions[bot] 4edb892b51 Update tables [2026-06-30] 2026-06-30 16:18:22 +00:00
anon (hello) 679f9698d9 Edit R.E.G.O (data_005.jsonl) 2026-06-30 16:18:12 +00:00
github-actions[bot] 0acee9d62c Update tables [2026-06-30] 2026-06-30 16:17:07 +00:00
anon (hello) c9df4469e2 Edit Crown Caps Soccer (data_005.jsonl) 2026-06-30 16:16:57 +00:00
anon (hello) 0114b6c62d Edit 天道模拟器之放置修仙 (data_005.jsonl) 2026-06-30 16:15:44 +00:00
github-actions[bot] 671b977ba1 Update tables [2026-06-30] 2026-06-30 16:14:55 +00:00
anon (hello) bc70c34a31 Bulk edit 3 games (1 shard) 2026-06-30 16:14:43 +00:00
github-actions[bot] 52089265cf Update tables [2026-06-30] 2026-06-30 16:13:06 +00:00
anon (hello) 4be66f365a Edit Terrarium.live (data_005.jsonl) 2026-06-30 16:12:53 +00:00
github-actions[bot] ee1b9d1fda Update tables [2026-06-30] 2026-06-30 16:09:18 +00:00
anon (hello) 388a9548d1 Edit Zenless Zone Zero (data_005.jsonl) 2026-06-30 16:09:05 +00:00
github-actions[bot] 07e821b5a5 Ingest games [2026-06-30 16:03] 2026-06-30 16:03:25 +00:00
steam-f2p-ext[bot] 07d08a593f ext: add 73 game(s) [2026-06-30] 2026-06-30 15:57:19 +00:00
github-actions[bot] 5756db8d90 Ingest games [2026-06-30 05:40] 2026-06-30 05:40:07 +00:00
steam-f2p-ext[bot] 184f233caf ext: add 59 game(s) [2026-06-30] 2026-06-30 05:35:10 +00:00
github-actions[bot] b5aa3315d2 Update tables [2026-06-30] 2026-06-30 00:41:59 +00:00
github-actions[bot] 950248db77 Auto update [2026-06-30] 2026-06-30 00:41:45 +00:00
github-actions[bot] 49bf56d4f3 Purge unhealthy [2026-06-29] 2026-06-29 08:23:03 +00:00
github-actions[bot] fad87ff461 chore(data): mark dead games 2026-06-29 06:06:24 +00:00
github-actions[bot] 8e43003ce8 Ingest games [2026-06-29 03:06] 2026-06-29 03:06:48 +00:00
steam-f2p-ext[bot] afe1532db9 ext: add 28 game(s) [2026-06-29] 2026-06-29 03:04:23 +00:00
github-actions[bot] bb6dd75bc2 Update tables [2026-06-29] 2026-06-29 00:43:43 +00:00
github-actions[bot] 00b43e9326 Auto update [2026-06-29] 2026-06-29 00:43:29 +00:00
github-actions[bot] b935a23bd3 Anti-cheat list [2026-06-28 07:22] 2026-06-28 07:22:08 +00:00
github-actions[bot] 69e71a5557 Top online [2026-06-28 04:53] 2026-06-28 04:53:38 +00:00
github-actions[bot] b2c3a7b6dd Update tables [2026-06-28] 2026-06-28 00:42:25 +00:00
github-actions[bot] e3e207775b Auto update [2026-06-28] 2026-06-28 00:42:13 +00:00
github-actions[bot] f0fc0eb0b5 Update reviews [2026-06-27] 2026-06-27 08:58:56 +00:00
github-actions[bot] 7d605a34ff Update tables [2026-06-27] 2026-06-27 00:41:18 +00:00
github-actions[bot] e61feab0de Auto update [2026-06-27] 2026-06-27 00:41:06 +00:00
github-actions[bot] 435deccdc2 Dead link check [2026-06-26] 2026-06-26 07:16:38 +00:00
github-actions[bot] 51df335beb Top online [2026-06-26 04:51] 2026-06-26 04:51:00 +00:00
github-actions[bot] b8d7b93cbd Update tables [2026-06-26] 2026-06-26 00:43:57 +00:00
github-actions[bot] 9fb4e0c51a Auto update [2026-06-26] 2026-06-26 00:43:45 +00:00
github-actions[bot] 651c9b200e Update reviews [2026-06-25] 2026-06-25 09:06:40 +00:00
github-actions[bot] 407e88bfb2 chore(data): mark dead games 2026-06-25 05:51:50 +00:00
github-actions[bot] a283f5e633 Update tables [2026-06-25] 2026-06-25 00:42:48 +00:00
github-actions[bot] d6ca334e5e Auto update [2026-06-25] 2026-06-25 00:42:35 +00:00
github-actions[bot] d9b7416e91 Top online [2026-06-24 04:48] 2026-06-24 04:48:34 +00:00
github-actions[bot] 5c64d4de3f Update tables [2026-06-24] 2026-06-24 00:37:33 +00:00
github-actions[bot] 7b24e9b8a1 Auto update [2026-06-24] 2026-06-24 00:37:21 +00:00
github-actions[bot] 0c349540d2 Update reviews [2026-06-23] 2026-06-23 09:09:42 +00:00
github-actions[bot] 00ab20b8fd Update tables [2026-06-23] 2026-06-23 00:42:36 +00:00
github-actions[bot] 040138e113 Auto update [2026-06-23] 2026-06-23 00:42:23 +00:00
github-actions[bot] 630b2f3dab Purge unhealthy [2026-06-22] 2026-06-22 08:36:00 +00:00
github-actions[bot] 7756c5ad5c chore(data): mark dead games 2026-06-22 06:18:24 +00:00
github-actions[bot] 4be19c2fee Update tables [2026-06-22] 2026-06-22 00:47:15 +00:00
github-actions[bot] 69ef5b28f4 Auto update [2026-06-22] 2026-06-22 00:46:57 +00:00
github-actions[bot] 0f4cfc8e01 Update reviews [2026-06-21] 2026-06-21 09:32:42 +00:00
github-actions[bot] 71b680c4af Anti-cheat list [2026-06-21 07:39] 2026-06-21 07:39:07 +00:00
github-actions[bot] 4e86059395 Dead link check [2026-06-21] 2026-06-21 07:26:31 +00:00
github-actions[bot] ec0299d274 Top online [2026-06-21 04:53] 2026-06-21 04:53:36 +00:00
github-actions[bot] 9f2286e583 Update tables [2026-06-21] 2026-06-21 00:47:24 +00:00
github-actions[bot] 5edd14ec3d Auto update [2026-06-21] 2026-06-21 00:47:12 +00:00
github-actions[bot] 3b285dcf68 Update tables [2026-06-20] 2026-06-20 00:43:16 +00:00
github-actions[bot] 369b174fdf Auto update [2026-06-20] 2026-06-20 00:43:05 +00:00
github-actions[bot] 9a1e121d18 Update reviews [2026-06-19] 2026-06-19 09:48:36 +00:00
github-actions[bot] 8cb1c750d9 Top online [2026-06-19 04:55] 2026-06-19 04:55:35 +00:00
github-actions[bot] 2cc42d2482 Auto update [2026-06-19] 2026-06-19 00:52:23 +00:00
github-actions[bot] 82e246b9ee chore(data): mark dead games 2026-06-18 06:09:08 +00:00
github-actions[bot] fa5ae31dee Update tables [2026-06-18] 2026-06-18 00:48:09 +00:00
github-actions[bot] 144ab4f4ce Auto update [2026-06-18] 2026-06-18 00:47:56 +00:00
github-actions[bot] ff2ccc93a7 Update reviews [2026-06-17] 2026-06-17 09:46:49 +00:00
github-actions[bot] 94a2e41e92 Top online [2026-06-17 04:53] 2026-06-17 04:53:54 +00:00
github-actions[bot] 144999d6fe Auto update [2026-06-17] 2026-06-17 00:48:07 +00:00
github-actions[bot] d7dba4a6a9 Dead link check [2026-06-16] 2026-06-16 07:39:38 +00:00
github-actions[bot] cbef5756d7 Auto update [2026-06-16] 2026-06-16 00:52:58 +00:00
poli0981andClaude Opus 4.8 188b403696 feat(android): minSdk → Android 11 (API 30) + hide Steam Desktop on mobile, v1.4.4 (#106)
- minSdk 24 -> 30: OS-level install gate (INSTALL_FAILED_OLDER_SDK) drops EOL
  Android 7-10 (no Google OS patches, stale WebView vs the React 19 bundle);
  minSdk 30 still reaches ~87% of active devices.
- Hide the steam:// "Steam Desktop" button on the Android app / sub-768px
  viewport via a new reactive useIsMobile hook; the Web button stays.
- Docs: new docs/android-support.md (+vi mirror) with requirement, rationale,
  tested devices (emulator 11-16, real vivo 1907 on Android 12) and a sourced
  version-share/EOL table; update TAURI.md, pc_spec.md (+vi), the
  release-android.yml notes, and the README badge/links.
- Bump 1.4.3 -> 1.4.4 (repo 3.4.1 -> 3.4.2) + Cargo.lock/package-lock sync.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 20:08:42 +07:00
github-actions[bot] 697b4fde76 Purge unhealthy [2026-06-15] 2026-06-15 08:35:38 +00:00
github-actions[bot] b5eb926e2d chore(data): mark dead games 2026-06-15 06:17:42 +00:00
github-actions[bot] 3f5d254b0b Update tables [2026-06-15] 2026-06-15 00:48:09 +00:00
github-actions[bot] 7e00eaf2f8 Auto update [2026-06-15] 2026-06-15 00:47:53 +00:00
poli0981andClaude Opus 4.8 95dd807b48 feat(android): status-bar appearance + Kotlin cross-drive build fix, v1.4.3 (#104)
- themes.xml (values + values-night): transparent system bars + light status/nav
  icons for the dark-by-default web UI under edge-to-edge (targetSdk 36), with
  contrast enforcement disabled.
- gradle.properties: kotlin.incremental=false to dodge the cross-drive cache
  relativization crash (Cargo registry on C:, project on E:) that forced a slow
  non-incremental Kotlin compile + noisy stack trace every build. Negligible
  cost (tiny Kotlin surface); harmless on single-drive CI.
- Bump to 1.4.3 (versionCode -> 1004003) across the six version slots.

Verified: debug APK builds and the Kotlin "different roots" error is gone.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 02:34:56 +07:00
poli0981andClaude Opus 4.8 7bd6a64711 feat(android): touch-zoom charts + in-app update check, v1.4.2 (#102)
* feat(android): touch-zoom charts + in-app update check

- ECharts: on touch devices (pointer: coarse) inject an inside dataZoom on each
  cartesian chart's category axis, so cramped many-category bar/line/heatmap
  charts pinch-zoom and pan on mobile. Centralized in EChart.tsx; desktop
  (pointer: fine) is untouched — no wheel-zoom hijacking page scroll.
  Pie/treemap/wordcloud (no axes) are skipped.
- Android update check: the Tauri updater plugin is desktop-only, so on Android
  the app polls GitHub Releases once per launch for a newer android-v* tag and
  shows a toast linking to the new APK. Exposes the package.json version to the
  bundle as __APP_VERSION__ (Vite define). New: lib/android-update.ts,
  hooks/useAndroidUpdateCheck.ts, isAndroid() helper, appUpdate i18n keys (en/vi).

Verified: typecheck + web build pass; __APP_VERSION__ is replaced at build time.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore(release): bump version to 1.4.2

Android release carrying the touch-zoom charts + in-app update check (PR #102).
versionCode auto-derives to 1004002. Synced across package.json,
package-lock.json, tauri.conf.json, Cargo.toml, Cargo.lock.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 02:08:00 +07:00
poli0981andClaude Opus 4.8 03b16030b4 feat(android): build the web app into a signed Android APK (Tauri 2 mobile) (#100)
* feat(android): scaffold Tauri 2 Android build — first working APK

Adds Android as a build target for the existing web app via Tauri 2 mobile.
A debug arm64 APK builds successfully on Windows (NDK 30 + JDK 21).

- gen/android: committed Tauri-mobile Gradle project (`tauri android init`).
  Build artefacts (build/, .gradle, jniLibs *.so, keystore.properties,
  tauri.properties) stay ignored via the nested .gitignore files.
- capabilities: split updater:default into a desktop-only capability
  (updater.json, platforms = win/linux/macOS) so the Android ACL resolution
  doesn't fail on the updater plugin that's gated out of mobile builds.
- external links: global capture-phase interceptor routes external <a>/links
  through the Tauri shell on desktop + Android (the webview blocks
  window.open to external HTTPS); convert the two window.open call sites
  (DeviceFlowPanel, Health) to openExternal.
- npm scripts: build:mobile + tauri:android:{init,dev,build}.
- src-tauri/.gitignore: gen/ -> gen/schemas/ so gen/android is committable.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* feat(android): native-HTTP OAuth + mobile UX polish

- OAuth Device Flow: route the two github.com/login/* endpoints (which send
  no CORS headers) through @tauri-apps/plugin-http so they work inside the
  Android System WebView, which — unlike desktop — enforces CORS. Falls back
  to window.fetch (+ optional VITE_GH_OAUTH_PROXY) on the plain web build.
  Adds the Rust tauri-plugin-http plugin + an http:default capability scoped
  to github.com / api.github.com.
- Layout: apply env(safe-area-inset-*) padding — edge-to-edge is forced on
  targetSdk 36 / Android 15, so the chrome must dodge the status/nav bars.
  No-op on web/desktop (insets are 0).
- Command palette: openable on touch via a mobile topbar button dispatching a
  custom event, since the soft keyboard can't send the Ctrl/Cmd+K chord.

Verified: typecheck, web build, and a debug arm64 APK build all pass; the
http:default ACL scope resolves on Android.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* ci(android): release signing config + GitHub Actions release workflow

- app/build.gradle.kts: add a `release` signingConfig sourced from
  gen/android/keystore.properties (gitignored). Guarded by the file's
  existence, so a keyless checkout still configures and unsigned/debug builds
  keep working; the release buildType signs only when the keystore is present.
- .github/workflows/release-android.yml: build a signed universal release APK
  on `android-v*` tags (JDK 17, Android SDK, NDK r27, the four Rust android
  targets), decoding the keystore from repo secrets into keystore.properties,
  then attach the APK to a draft GitHub Release. Documents the four required
  secrets (ANDROID_KEYSTORE_BASE64 / _PASSWORD / KEY_ALIAS / KEY_PASSWORD).

Verified the gradle DSL parses via a debug APK build. Signing itself is
exercised once the keystore exists (user-generated, kept out of the repo).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs(android): document the Tauri 2 Android build, signing, and CI

Extend TAURI.md (now "desktop + Android") with an Android section: SDK/NDK/JDK
prerequisites, build commands, keystore signing + backup warning, the
release-android.yml CI secrets, and notes on the desktop-only updater,
edge-to-edge safe areas, the plugin-http OAuth bridge, and the Kotlin
cross-drive incremental-compile fallback.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 01:31:08 +07:00
poli0981andClaude Opus 4.8 8bb3a5f042 docs(web): describe v3.4.1 build stack as Vite 8 + Rolldown (#99)
* docs(web): describe v3.4.1 build stack as Vite 8 + Rolldown

The web build migrated from Vite 7 (rollup + esbuild) to Vite 8, which
uses the Rolldown bundler; esbuild and standalone rollup are no longer in
the dependency tree. Reconcile the stack documentation with reality:

- docs/ACKNOWLEDGEMENTs.md: "Vite 7" -> "Vite 8 + Rolldown" in the
  Runtime & build list.
- web/src/pages/About.tsx: bump the in-app "Stack & third-party" list
  entry "Vite 7" -> "Vite 8 (Rolldown)" and add a Rolldown row.
- web/README.md: Stack line now reads "Vite 8 (Rolldown bundler)".
- web/src/gpgauth/README.md: stale "Rollup" bundler note -> "Rolldown".

Docs-only / content cleanup follow-up to v3.4.1. No canonical version
files, source logic, or CHANGELOG history touched. typecheck + build
pass; knip shows only pre-existing unused exports.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore(web): sync package-lock version to 1.4.1

The v3.4.1 bump updated web/package.json to 1.4.1 but left
web/package-lock.json at 1.4.0, so `npm install` kept re-touching the
lockfile. Sync the lockfile `version` fields to match. No dependency
graph changes — only the two version lines.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 20:47:17 +07:00
poli0981andClaude Opus 4.8 af1da4daac fix(web): chart tabs render again under Vite 8 / Rolldown (React #130) — v3.4.1 (#96)
The Vite 8 / Rolldown migration (#95) introduced a production regression:
every chart tab threw React error #130 ("Element type is invalid... got:
object") and failed to render — all pages/charts/* plus the Dashboard.

Root cause: EChart.tsx imported the wrapper from
`echarts-for-react/lib/core` (the CommonJS build). Under Rolldown the
CJS default-interop wraps `module.exports = class` into a namespace
object, so <ReactEChartsCore/> received an object instead of a
component. Switched to the ESM build `echarts-for-react/esm/core`, which
has a clean `export default`. echarts core / 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 stay lazy
async chunks (not eager-preloaded).

Also documents the glib Dependabot advisory (GHSA-wrw7-89jp-8q8g,
medium, Linux-only) as accepted: it cannot be fixed within Tauri 2.x
(webkit2gtk 2.0.2 pins glib ^0.18; Tauri 3 unreleased) and the deployed
surfaces are unaffected. Alert to be dismissed as tolerable risk.

Version: repo 3.4.0 -> 3.4.1; web + desktop 1.4.0 -> 1.4.1.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 20:00:02 +07:00
poli0981andClaude Opus 4.8 5811e87cd9 fix(web): migrate Vite config to Vite 8 / Rolldown — restore Pages deploy (#95)
PR #92 (nominally an esbuild security bump) silently upgraded vite 7→8
and @vitejs/plugin-react 4→6. Vite 8 switches the bundler from
rollup+esbuild to Rolldown, which dropped the object form of
`build.rollupOptions.output.manualChunks`. That broke `tsc -b` typecheck
in the Deploy Web (GitHub Pages) workflow, failing every push since the
merge and freezing the live site.

Replace the object-form manualChunks with Rolldown's
`advancedChunks.groups`, keeping the three vendor groups (react / query /
table) and deliberately NOT grouping echarts/openpgp so they stay behind
their dynamic-import boundaries (verified: neither is modulepreloaded in
dist/index.html).

esbuild is no longer in the dependency tree under Vite 8 (npm ci reports
0 vulnerabilities), so the dev-only advisory GHSA-g7r4-m6w7-qqqr is
resolved without an override.

Verified locally: npm ci, typecheck, build, build:desktop all pass; PWA
service worker generated; echarts/openpgp remain separate async chunks.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 19:20:10 +07:00
github-actions[bot] bb3aed5ffb Ingest games [2026-06-14 11:59] 2026-06-14 11:59:40 +00:00
steam-f2p-ext[bot] 621ac61e06 ext: add 32 game(s) [2026-06-14] 2026-06-14 11:56:55 +00:00
github-actions[bot] 303fa72ba4 Ingest games [2026-06-14 11:44] 2026-06-14 11:44:22 +00:00
steam-f2p-ext[bot] d5ef8f80d0 ext: add 9 game(s) [2026-06-14] 2026-06-14 11:43:33 +00:00
dependabot[bot] 9384b7f67f Bump tar in /web/src-tauri in the cargo group across 1 directory (#87)
Bumps the cargo group with 1 update in the /web/src-tauri directory: [tar](https://github.com/composefs/tar-rs).


Updates `tar` from 0.4.45 to 0.4.46
- [Release notes](https://github.com/composefs/tar-rs/releases)
- [Commits](https://github.com/composefs/tar-rs/compare/0.4.45...0.4.46)

---
updated-dependencies:
- dependency-name: tar
  dependency-version: 0.4.46
  dependency-type: indirect
  dependency-group: cargo
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-14 14:51:48 +07:00
dependabot[bot] 0daab5f01b Bump esbuild in /web in the npm_and_yarn group across 1 directory (#92)
Bumps the npm_and_yarn group with 1 update in the /web directory: [esbuild](https://github.com/evanw/esbuild).


Removes `esbuild`

---
updated-dependencies:
- dependency-name: esbuild
  dependency-version:
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-14 14:51:25 +07:00
github-actions[bot] 769f8fdcea Anti-cheat list [2026-06-14 07:36] 2026-06-14 07:36:46 +00:00
github-actions[bot] 06ce911456 Top online [2026-06-14 04:53] 2026-06-14 04:53:45 +00:00
github-actions[bot] 25b1a9e2fc Update tables [2026-06-14] 2026-06-14 00:46:10 +00:00
github-actions[bot] edea5e5c0a Auto update [2026-06-14] 2026-06-14 00:45:56 +00:00
poli0981andClaude Opus 4.8 14b2865c5b v3.4.0: legal consent gate (web first-run + Windows installer license page) (#93)
Web/in-app first-run consent gate (ConsentGate wrapped around <App/> inside
HashRouter): full-screen card, checkbox-gated Continue, explicit Decline
(desktop quits via getCurrentWindow().close(); web shows a blocking notice).
Acceptance persisted in localStorage (f2p:legal_consent) and versioned via a
TERMS_VERSION constant so terms changes re-prompt everyone; incognito tabs get
a fresh partition so the gate re-shows there with no extra code. Error routes
(#/error/*) pass through. Doc links open via the existing openExternal() helper
so they work inside the Tauri webview.

Lifted LEGAL_DOCS out of About.tsx into a shared lib/legal.ts (LEGAL_DOCS,
CONSENT_DOCS, legalDocUrl); About now imports it. New consent.* i18n keys in
en.json + vi.json.

Windows installer license page: bundle.licenseFile -> LICENSE_AGREEMENT.rtf
(ASCII, no BOM) — mandatory "I Agree" page on both NSIS .exe and WiX .msi.
Added @tauri-apps/api dep (lazy-imported, desktop decline only) and
core:window:allow-close capability.

Version bump 1.3.0 -> 1.4.0 (package.json, tauri.conf.json, Cargo.toml,
Cargo.lock); repo 3.3.0 -> 3.4.0 (CHANGELOG, README badge). typecheck/knip/
build/vulture/pip-audit clean.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 22:40:45 +07:00
github-actions[bot] 3f7fc81b01 Update reviews [2026-06-13] 2026-06-13 09:11:37 +00:00
github-actions[bot] 796e421c05 Update tables [2026-06-13] 2026-06-13 00:47:20 +00:00
github-actions[bot] 5046d53a17 Auto update [2026-06-13] 2026-06-13 00:47:08 +00:00
poli0981andClaude Fable 5 ca4187dba8 ci: gate ingest-new to branch pushes — stop spurious tag-push failures
Tag pushes (v*, desktop-v*) match the paths filter against an empty base,
so every release fired the ingest on a detached HEAD and failed with exit
128 (lesson 23 was only "resolved" by a lucky no-op .gen-hash). branches:
[main] excludes tag refs from the trigger entirely.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 15:05:55 +07:00
poli0981andClaude Fable 5 6a1526b450 v3.3.0: web perf overhaul (lazy-load) + error-page system (#89)
Performance: route-level code splitting via lazyWithRetry; echarts behind
LazyEChart; openpgp dynamic import; per-locale i18n (vi.json lazy, en
bundled as fallback); removed echarts/openpgp from manualChunks (tslib
hoisting made the eager graph preload echarts); decoding=async sweep;
preferWebp for drawer header (Tauri excluded, onError fallback);
useDeferredValue search; preconnect hints; rollup-plugin-visualizer +
npm run analyze. First-load JS ~574 KB -> ~163 KB gzip (-72%).

Error pages: ErrorPage 403/404/419/500/502/503/504/offline + #/error/:code
routes + real 404 catch-all (was silent redirect); ErrorBoundary (route +
top-level); GitHub Pages 404.html (SW globIgnores); ErrorState offline
copy + retry/report actions wired at 17 call sites; 419 toast on expired
token with Open Settings action. Full en/vi translations.

Versions: web/desktop 1.2.7 -> 1.3.0 (Cargo.lock synced), repo 3.2.7 ->
3.3.0. npm audit fix: react-router GHSA-2j2x-hqr9-3h42. knip/typecheck/
build/npm audit/vulture/pip-audit all clean.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 14:54:59 +07:00
github-actions[bot] 1d8c5fa4b6 Top online [2026-06-12 04:53] 2026-06-12 04:53:10 +00:00
github-actions[bot] 5c68505299 Update tables [2026-06-12] 2026-06-12 00:47:53 +00:00
github-actions[bot] d5e98c24ec Auto update [2026-06-12] 2026-06-12 00:47:41 +00:00
github-actions[bot] 8523e1be33 Update reviews [2026-06-11] 2026-06-11 09:35:03 +00:00
github-actions[bot] 9cc3d66a6b Update tables [2026-06-11] 2026-06-11 07:24:48 +00:00
anon (hello) 8fb762a36e Bulk edit 5 games (2 shards) 2026-06-11 07:02:06 +00:00
anon (hello) e773aefa67 Bulk edit 16 games (3 shards) 2026-06-11 06:52:58 +00:00
anon (hello) 3153667289 Bulk edit 4 games (2 shards) 2026-06-11 06:30:46 +00:00
anon (hello) de33207de1 Edit Xeno Strike (data_004.jsonl) 2026-06-11 06:22:50 +00:00
anon (hello) 69e4dc6216 Edit 爆战联盟 (data_004.jsonl) 2026-06-11 05:53:03 +00:00
anon (hello) 2e60c480de Edit Nautical Dispute (data_004.jsonl) 2026-06-11 05:51:27 +00:00
anon (hello) 71595eadbe Edit Elect (data_005.jsonl) 2026-06-11 05:50:23 +00:00
anon (hello) 6db935e48d Edit EXTERMINIUM (data_005.jsonl) 2026-06-11 05:49:19 +00:00
anon (hello) 516e4f4a18 Edit Cultist (data_004.jsonl) 2026-06-11 05:35:06 +00:00
github-actions[bot] 73548211b9 Update tables [2026-06-11] 2026-06-11 05:33:04 +00:00
anon (hello) b999d49eab Edit The Reserve (data_004.jsonl) 2026-06-11 05:32:56 +00:00
github-actions[bot] 6dce59bede Update tables [2026-06-11] 2026-06-11 05:26:27 +00:00
anon (hello) 1b7b64fbc5 Bulk edit 3 games (2 shards) 2026-06-11 05:26:18 +00:00
github-actions[bot] bf8ccd627c Update tables [2026-06-11] 2026-06-11 05:15:17 +00:00
anon (hello) 8e4d4fda4e Bulk edit 5 games (2 shards) 2026-06-11 05:15:07 +00:00
github-actions[bot] eb41bad55e Update tables [2026-06-11] 2026-06-11 05:05:36 +00:00
anon (hello) 2172da2224 Edit Damn Exam (data_004.jsonl) 2026-06-11 05:05:26 +00:00
github-actions[bot] 708cca2485 Update tables [2026-06-11] 2026-06-11 05:02:15 +00:00
anon (hello) 283ad05dbf Edit Classic: Snake (data_004.jsonl) 2026-06-11 05:02:06 +00:00
github-actions[bot] 47d3816e1b Update tables [2026-06-11] 2026-06-11 05:00:05 +00:00
anon (hello) ba3794fcbb Edit GlowCore (data_004.jsonl) 2026-06-11 04:59:55 +00:00
github-actions[bot] 1522b731c9 Update tables [2026-06-11] 2026-06-11 04:57:59 +00:00
anon (hello) 334bbb9d40 Edit Minkle's Masks of Mayhem (data_004.jsonl) 2026-06-11 04:57:50 +00:00
github-actions[bot] 9cdbb4e485 Update tables [2026-06-11] 2026-06-11 04:55:14 +00:00
anon (hello) 69cc48cc8f Edit GoatBrains (data_004.jsonl) 2026-06-11 04:55:05 +00:00
github-actions[bot] a709a31758 Update tables [2026-06-11] 2026-06-11 04:53:48 +00:00
anon (hello) 06865ac246 Edit Sushi Courier! (data_004.jsonl) 2026-06-11 04:53:40 +00:00
anon (hello) ee0be443ff Bulk delete 1 game 2026-06-11 04:45:39 +00:00
github-actions[bot] f3c8819273 Update tables [2026-06-11] 2026-06-11 04:21:17 +00:00
anon (hello) 584d80c476 Bulk edit 2 games (2 shards) 2026-06-11 04:21:09 +00:00
github-actions[bot] fcc2b06163 Update tables [2026-06-11] 2026-06-11 04:05:11 +00:00
anon (hello) a0a66236af Bulk edit 4 games (2 shards) 2026-06-11 04:05:04 +00:00
github-actions[bot] 77e4d0be56 Update tables [2026-06-11] 2026-06-11 03:52:32 +00:00
anon (hello) 499fbea1b4 Bulk edit 57 games (3 shards) 2026-06-11 03:52:22 +00:00
github-actions[bot] a694c9ca66 Update tables [2026-06-11] 2026-06-11 02:17:57 +00:00
anon (hello) 651b34c06d Bulk edit 16 games (2 shards) 2026-06-11 02:17:48 +00:00
github-actions[bot] 5d655e65e5 Update tables [2026-06-11] 2026-06-11 02:08:24 +00:00
anon (hello) af72155c88 Bulk edit 19 games (2 shards) 2026-06-11 02:08:13 +00:00
github-actions[bot] e181e57c5d Update tables [2026-06-11] 2026-06-11 01:59:17 +00:00
anon (hello) 0ee1a4e539 Edit Old But Gold (data_004.jsonl) 2026-06-11 01:59:06 +00:00
github-actions[bot] 875bb7e3f3 Update tables [2026-06-11] 2026-06-11 01:47:07 +00:00
anon (hello) 5b85879483 Edit Meteor Swarm Old School (data_004.jsonl) 2026-06-11 01:46:56 +00:00
github-actions[bot] 4c2e70dc05 Update tables [2026-06-11] 2026-06-11 01:45:03 +00:00
anon (hello) d855761be4 Edit Blooming Winter (data_004.jsonl) 2026-06-11 01:44:52 +00:00
github-actions[bot] d31e899746 Auto update [2026-06-11] 2026-06-11 00:45:54 +00:00
github-actions[bot] d3f8c7b90d Update tables [2026-06-10] 2026-06-10 14:44:49 +00:00
anon (hello) f6e57f87d1 Edit MoSimulator (data_004.jsonl) 2026-06-10 14:44:35 +00:00
github-actions[bot] 261c4a9a6c Update tables [2026-06-10] 2026-06-10 14:41:00 +00:00
anon (hello) 28ca744327 Edit The Retro Exorcist (data_004.jsonl) 2026-06-10 14:40:46 +00:00
github-actions[bot] 3546506892 Update tables [2026-06-10] 2026-06-10 12:37:41 +00:00
anon (hello) fd017ebf50 Edit Escape Line (data_004.jsonl) 2026-06-10 12:37:28 +00:00
github-actions[bot] 1735a96d81 Update tables [2026-06-10] 2026-06-10 12:18:20 +00:00
anon (hello) c6d79426c0 Edit Apology Video (data_004.jsonl) 2026-06-10 12:18:08 +00:00
github-actions[bot] ba4ede4321 Update tables [2026-06-10] 2026-06-10 09:47:24 +00:00
anon (hello) b1b7e33aa4 Edit Kaetram (data_004.jsonl) 2026-06-10 09:47:11 +00:00
github-actions[bot] 24173021ee Update tables [2026-06-10] 2026-06-10 09:44:14 +00:00
anon (hello) 3f04404c33 Edit Sefirot Shards (data_004.jsonl) 2026-06-10 09:44:01 +00:00
github-actions[bot] dbbd65107f Update tables [2026-06-10] 2026-06-10 09:38:38 +00:00
anon (hello) b625bb25b2 Edit Red Stone Online (data_004.jsonl) 2026-06-10 09:38:24 +00:00
github-actions[bot] 76819b8e11 Top online [2026-06-10 04:50] 2026-06-10 04:50:06 +00:00
github-actions[bot] 7a4acc30c8 Auto update [2026-06-10] 2026-06-10 00:45:32 +00:00
github-actions[bot] 18f5472b5c Ingest games [2026-06-09 16:52] 2026-06-09 16:52:44 +00:00
steam-f2p-ext[bot] 29bf919a3c ext: add 150 game(s) [2026-06-09] 2026-06-09 16:40:25 +00:00
github-actions[bot] 0a8b0003b5 Update reviews [2026-06-09] 2026-06-09 09:03:56 +00:00
github-actions[bot] 8dff80f538 Ingest games [2026-06-09 05:12] 2026-06-09 05:12:52 +00:00
steam-f2p-ext[bot] 54bbaf091f ext: add 46 game(s) [2026-06-09] 2026-06-09 05:09:04 +00:00
github-actions[bot] 6b7cf2cd29 Auto update [2026-06-09] 2026-06-09 00:39:48 +00:00
github-actions[bot] ce70048d4e Purge unhealthy [2026-06-08] 2026-06-08 08:13:54 +00:00
github-actions[bot] f6a163cddd chore(data): mark dead games 2026-06-08 06:07:55 +00:00
github-actions[bot] 9e6e77a81b Update tables [2026-06-08] 2026-06-08 00:45:36 +00:00
github-actions[bot] 48e2cb8f01 Auto update [2026-06-08] 2026-06-08 00:45:25 +00:00
github-actions[bot] 10f20b664c Update reviews [2026-06-07] 2026-06-07 09:11:15 +00:00
github-actions[bot] eb8ccd59cd Anti-cheat list [2026-06-07 07:24] 2026-06-07 07:24:51 +00:00
github-actions[bot] 540c16b16d Top online [2026-06-07 04:51] 2026-06-07 04:51:42 +00:00
github-actions[bot] 537f3f81a5 Update tables [2026-06-07] 2026-06-07 00:44:47 +00:00
github-actions[bot] ca6cc44b1c Auto update [2026-06-07] 2026-06-07 00:44:35 +00:00
github-actions[bot] 1e4f30b232 Dead link check [2026-06-06] 2026-06-06 07:00:25 +00:00
github-actions[bot] 6c8ff04a38 Update tables [2026-06-06] 2026-06-06 00:41:52 +00:00
github-actions[bot] c680112128 Auto update [2026-06-06] 2026-06-06 00:41:38 +00:00
github-actions[bot] f7b10d877f Update reviews [2026-06-05] 2026-06-05 09:16:31 +00:00
github-actions[bot] be7226af49 Top online [2026-06-05 04:50] 2026-06-05 04:50:09 +00:00
github-actions[bot] aab60855e3 Auto update [2026-06-05] 2026-06-05 00:44:03 +00:00
github-actions[bot] e400885b1b chore(data): mark dead games 2026-06-04 06:08:04 +00:00
github-actions[bot] 0dfdcd72b9 Ingest games [2026-06-04 00:59] 2026-06-04 00:59:52 +00:00
steam-f2p-ext[bot] 3a7741083a ext: add 5 game(s) [2026-06-04] 2026-06-04 00:59:13 +00:00
github-actions[bot] 8c5ced17e8 Update tables [2026-06-04] 2026-06-04 00:51:33 +00:00
github-actions[bot] b939d9df39 Auto update [2026-06-04] 2026-06-04 00:51:20 +00:00
github-actions[bot] f069513d89 Update reviews [2026-06-03] 2026-06-03 09:30:30 +00:00
github-actions[bot] 4cdc156560 Ingest games [2026-06-03 06:49] 2026-06-03 06:49:32 +00:00
steam-f2p-ext[bot] bdf62f0160 ext: add 74 game(s) [2026-06-03] 2026-06-03 06:43:22 +00:00
github-actions[bot] fa268e77ef Top online [2026-06-03 04:50] 2026-06-03 04:50:39 +00:00
github-actions[bot] 903830d88a Update tables [2026-06-03] 2026-06-03 00:51:39 +00:00
github-actions[bot] da000ada9d Auto update [2026-06-03] 2026-06-03 00:51:28 +00:00
github-actions[bot] f0eafbb991 Update tables [2026-06-02] 2026-06-02 00:46:22 +00:00
github-actions[bot] ac28ee65bb Auto update [2026-06-02] 2026-06-02 00:46:10 +00:00
github-actions[bot] 13ed53eaaa Update reviews [2026-06-01] 2026-06-01 09:32:41 +00:00
github-actions[bot] e201b39fc4 Dead link check [2026-06-01] 2026-06-01 07:17:06 +00:00
github-actions[bot] d7c462fd1d Ingest games [2026-06-01 01:15] 2026-06-01 01:15:56 +00:00
steam-f2p-ext[bot] 1a9ad951d4 ext: add 15 game(s) [2026-06-01] 2026-06-01 01:14:30 +00:00
github-actions[bot] 929543cf38 Update tables [2026-06-01] 2026-06-01 00:45:09 +00:00
github-actions[bot] 8989147fb0 Auto update [2026-06-01] 2026-06-01 00:44:58 +00:00
github-actions[bot] 4b308ce5d5 Ingest games [2026-06-01 00:29] 2026-06-01 00:29:57 +00:00
steam-f2p-ext[bot] fbfc8e7480 ext: add 12 game(s) [2026-06-01] 2026-06-01 00:28:47 +00:00
github-actions[bot] 5e9cae4ccd Update reviews [2026-05-31] 2026-05-31 09:00:59 +00:00
github-actions[bot] 01a4c22568 Anti-cheat list [2026-05-31 07:19] 2026-05-31 07:19:36 +00:00
github-actions[bot] af9a251457 Top online [2026-05-31 04:50] 2026-05-31 04:50:32 +00:00
github-actions[bot] 8f4525ee53 Auto update [2026-05-31] 2026-05-31 00:42:37 +00:00
github-actions[bot] b7400e6553 Update tables [2026-05-30] 2026-05-30 00:40:16 +00:00
github-actions[bot] 02dcdc9b24 Auto update [2026-05-30] 2026-05-30 00:40:05 +00:00
github-actions[bot] cb4919b2cb Update reviews [2026-05-29] 2026-05-29 09:04:54 +00:00
github-actions[bot] 2ebacdfe64 Top online [2026-05-29 04:48] 2026-05-29 04:48:35 +00:00
github-actions[bot] 71863f95da Update tables [2026-05-29] 2026-05-29 00:43:43 +00:00
github-actions[bot] 341119d0bd Auto update [2026-05-29] 2026-05-29 00:43:33 +00:00
github-actions[bot] 85f8fd5d64 chore(data): mark dead games 2026-05-28 05:58:29 +00:00
github-actions[bot] cbca021fa3 Update tables [2026-05-28] 2026-05-28 00:37:39 +00:00
github-actions[bot] c9afa7eb0b Auto update [2026-05-28] 2026-05-28 00:37:25 +00:00
github-actions[bot] 6615a0eb1e Update reviews [2026-05-27] 2026-05-27 09:11:52 +00:00
github-actions[bot] ac093e2ea8 Top online [2026-05-27 04:49] 2026-05-27 04:49:50 +00:00
github-actions[bot] c02cf00bff Ingest games [2026-05-27 02:54] 2026-05-27 02:54:50 +00:00
steam-f2p-ext[bot] 675ec884bc ext: add 150 game(s) [2026-05-27] 2026-05-27 02:42:34 +00:00
github-actions[bot] 012586580e Update tables [2026-05-27] 2026-05-27 01:43:38 +00:00
anon (hello) 5ed4bae231 Edit WonderKing (data_001.jsonl) 2026-05-27 01:43:29 +00:00
github-actions[bot] 4b324b84f3 Update tables [2026-05-27] 2026-05-27 01:12:44 +00:00
anon (hello) 9f64b70ff8 Bulk edit 4 games (1 shard) 2026-05-27 01:12:32 +00:00
github-actions[bot] 97e12ef5d9 Update tables [2026-05-27] 2026-05-27 00:40:56 +00:00
github-actions[bot] 68b2bb92a0 Auto update [2026-05-27] 2026-05-27 00:40:44 +00:00
github-actions[bot] 8d86e6a243 Ingest games [2026-05-26 23:10] 2026-05-26 23:10:32 +00:00
steam-f2p-ext[bot] 6f12e75836 ext: add 1 game(s) [2026-05-26] 2026-05-26 11:34:45 +00:00
steam-f2p-ext[bot] af9b5f5344 ext: add 149 game(s) [2026-05-26] 2026-05-26 11:20:43 +00:00
github-actions[bot] fa2e52d06d Ingest games [2026-05-26 06:58] 2026-05-26 06:58:02 +00:00
steam-f2p-ext[bot] cc76f4d192 ext: add 150 game(s) [2026-05-26] 2026-05-26 05:30:42 +00:00
anon (hello) ae03453186 Edit Epic Arena (data_004.jsonl) 2026-05-26 05:28:31 +00:00
github-actions[bot] 4c14f9e712 Ingest games [2026-05-26 03:08] 2026-05-26 03:08:11 +00:00
steam-f2p-ext[bot] 6c113fa769 ext: add 97 game(s) [2026-05-26] 2026-05-26 03:00:17 +00:00
github-actions[bot] 595f9b92ee Update tables [2026-05-26] 2026-05-26 01:59:55 +00:00
anon (hello) 8df93c04f9 Edit Gather CCG (data_002.jsonl) 2026-05-26 01:59:48 +00:00
github-actions[bot] ff45e012ac Update tables [2026-05-26] 2026-05-26 01:58:14 +00:00
anon (hello) 0f1ce91580 Edit Sanctum Ruins (data_002.jsonl) 2026-05-26 01:58:05 +00:00
github-actions[bot] 2a6485c232 Update tables [2026-05-26] 2026-05-26 01:55:29 +00:00
anon (hello) cbc448894e Edit Archon Soul: Prologue (data_001.jsonl) 2026-05-26 01:55:20 +00:00
github-actions[bot] 50c44952a0 Update tables [2026-05-26] 2026-05-26 01:52:35 +00:00
anon (hello) b36fff8acc Edit Linda & Joan Prologue: “Four Months Earlier” (data_003.jsonl) 2026-05-26 01:52:28 +00:00
github-actions[bot] 8e791e1872 Update tables [2026-05-26] 2026-05-26 01:51:16 +00:00
anon (hello) 23ef2f3940 Edit Evergreen Blues (data_003.jsonl) 2026-05-26 01:51:07 +00:00
github-actions[bot] 4cf233a988 Update tables [2026-05-26] 2026-05-26 01:49:42 +00:00
anon (hello) 597ddbd267 Edit Fun Park Simulator: Prologue (data_003.jsonl) 2026-05-26 01:49:34 +00:00
github-actions[bot] a51f112c43 Update tables [2026-05-26] 2026-05-26 01:48:13 +00:00
anon (hello) 96a993cb95 Edit Hero Company (data_003.jsonl) 2026-05-26 01:48:05 +00:00
github-actions[bot] 35d4f5d871 Update tables [2026-05-26] 2026-05-26 01:34:47 +00:00
anon (hello) 6392bda6bf Bulk edit 5 games (1 shard) 2026-05-26 01:34:39 +00:00
github-actions[bot] eee9a82630 Update tables [2026-05-26] 2026-05-26 01:31:57 +00:00
anon (hello) d150f53138 Edit Love And Order (data_003.jsonl) 2026-05-26 01:31:48 +00:00
github-actions[bot] 82d73c1f0c Update tables [2026-05-26] 2026-05-26 01:30:14 +00:00
anon (hello) 68e86d4a07 Edit Whose Lawn Is It Anyway (data_004.jsonl) 2026-05-26 01:30:06 +00:00
github-actions[bot] ce386b4ebc Update tables [2026-05-26] 2026-05-26 01:07:28 +00:00
anon (hello) ae6e65ce17 Edit Freshman Year (data_003.jsonl) 2026-05-26 01:07:20 +00:00
github-actions[bot] 852b96208d Update tables [2026-05-26] 2026-05-26 01:01:03 +00:00
anon (hello) 3c940de7ed Edit Impressions (data_003.jsonl) 2026-05-26 01:00:54 +00:00
github-actions[bot] 093169f76e Update tables [2026-05-26] 2026-05-26 00:39:55 +00:00
github-actions[bot] 36857b6f9d Auto update [2026-05-26] 2026-05-26 00:39:44 +00:00
github-actions[bot] 24d79abb76 Ingest games [2026-05-25 16:04] 2026-05-25 16:04:05 +00:00
steam-f2p-ext[bot] 0fa824a22e ext: add 36 game(s) [2026-05-25] 2026-05-25 16:00:56 +00:00
github-actions[bot] 53f56a8276 Update tables [2026-05-25] 2026-05-25 15:59:18 +00:00
anon (hello) 28d3a38adc Edit Saving You From Yourself (data_003.jsonl) 2026-05-25 15:59:08 +00:00
github-actions[bot] 274c83eff7 Update tables [2026-05-25] 2026-05-25 15:52:18 +00:00
anon (hello) c34f5fc326 Edit Drinks With Abbey (data_003.jsonl) 2026-05-25 15:52:09 +00:00
github-actions[bot] 362558b7d3 Update tables [2026-05-25] 2026-05-25 15:47:03 +00:00
anon (hello) 8cb679d52f Edit Adventures in Morality: An Interactive Case Study (data_003.jsonl) 2026-05-25 15:46:53 +00:00
github-actions[bot] 0112fae40b Update tables [2026-05-25] 2026-05-25 15:45:14 +00:00
anon (hello) 3e575fda89 Edit The falling tower (data_003.jsonl) 2026-05-25 15:45:02 +00:00
github-actions[bot] 351c61f122 Update reviews [2026-05-25] 2026-05-25 09:09:24 +00:00
github-actions[bot] 7d0e44bcd1 chore(data): mark dead games 2026-05-25 06:00:55 +00:00
github-actions[bot] a1c119e1e5 Update tables [2026-05-25] 2026-05-25 00:41:07 +00:00
github-actions[bot] 1a6ea60d9c Auto update [2026-05-25] 2026-05-25 00:40:54 +00:00
github-actions[bot] 009ddfe718 Anti-cheat list [2026-05-24 07:07] 2026-05-24 07:07:13 +00:00
github-actions[bot] 8c7ff6ebce Top online [2026-05-24 04:41] 2026-05-24 04:41:17 +00:00
github-actions[bot] c61278bb9a Auto update [2026-05-24] 2026-05-24 00:39:34 +00:00
github-actions[bot] 6dbcf9c1e4 Update tables [2026-05-23] 2026-05-23 12:24:08 +00:00
poli0981 068d060049 Edit Depression Quest (data_003.jsonl) 2026-05-23 12:23:58 +00:00
github-actions[bot] 53832067bf Update reviews [2026-05-23] 2026-05-23 10:14:55 +00:00
github-actions[bot] e8df0376af Ingest games [2026-05-23 08:40] 2026-05-23 08:40:00 +00:00
steam-f2p-ext[bot] b1c2c4b0f5 ext: add 74 game(s) [2026-05-23] 2026-05-23 08:33:50 +00:00
github-actions[bot] b91ce692fe Ingest games [2026-05-23 08:23] 2026-05-23 08:23:36 +00:00
steam-f2p-ext[bot] 405397946b ext: add 150 game(s) [2026-05-23] 2026-05-23 07:11:52 +00:00
github-actions[bot] 762ec99183 Update tables [2026-05-23] 2026-05-23 06:01:32 +00:00
anon (hello) a3a59f07ab Edit Idle Spiral (data_003.jsonl) 2026-05-23 06:01:24 +00:00
github-actions[bot] 5e4870c2de Update tables [2026-05-23] 2026-05-23 05:57:47 +00:00
anon (hello) 7e56bd73fd Bulk edit 2 games (1 shard) 2026-05-23 05:57:39 +00:00
github-actions[bot] f59e9a9740 Update tables [2026-05-23] 2026-05-23 05:56:19 +00:00
anon (hello) 73db6e3b6a Edit My Lands: Black Gem Hunting (data_003.jsonl) 2026-05-23 05:56:12 +00:00
github-actions[bot] 69b010fe40 Update tables [2026-05-23] 2026-05-23 05:54:58 +00:00
anon (hello) 53d529e341 Bulk edit 2 games (1 shard) 2026-05-23 05:54:51 +00:00
github-actions[bot] 1199e453d3 Update tables [2026-05-23] 2026-05-23 05:39:26 +00:00
anon (hello) 9da657ab65 Bulk edit 5 games (2 shards) 2026-05-23 05:39:19 +00:00
github-actions[bot] 1ac70415e5 Update tables [2026-05-23] 2026-05-23 05:35:58 +00:00
anon (hello) 858bb34574 Edit Gator Hucker (data_003.jsonl) 2026-05-23 05:35:50 +00:00
github-actions[bot] 6284df9af3 Update tables [2026-05-23] 2026-05-23 05:34:21 +00:00
anon (hello) 850b773abb Edit Watch (data_003.jsonl) 2026-05-23 05:34:12 +00:00
github-actions[bot] c4632d3b1e Auto update [2026-05-23] 2026-05-23 00:39:04 +00:00
poli0981 138e5186be v3.2.7: coming-soon guard, dead-code cleanup, dev tooling (#84)
Coming-soon games rejected at ingest (health_checker COMING_SOON status). Dead-code cleanup via knip + vulture: 2 unused web files, 11 npm deps, the one-shot dedup_removed_games.py. New knip/vulture/pip-audit dev tooling + docs/THIRD_PARTY.md. Bump 3.2.6 -> 3.2.7 (desktop 1.2.6 -> 1.2.7).
2026-05-22 23:17:10 +07:00
github-actions[bot] ab6d037938 Ingest games [2026-05-22 14:58] 2026-05-22 14:58:04 +00:00
steam-f2p-ext[bot] eb8711b3b9 ext: add 1 game(s) [2026-05-22] 2026-05-22 14:57:40 +00:00
github-actions[bot] 0f27825113 Top online [2026-05-22 04:40] 2026-05-22 04:40:08 +00:00
github-actions[bot] a27f40cdf5 Auto update [2026-05-22] 2026-05-22 00:39:39 +00:00
github-actions[bot] 8a32062684 Ingest games [2026-05-21 14:40] 2026-05-21 14:40:07 +00:00
steam-f2p-ext[bot] ef6eef79d2 ext: add 64 game(s) [2026-05-21] 2026-05-21 14:34:46 +00:00
github-actions[bot] f2162672e3 Update reviews [2026-05-21] 2026-05-21 08:32:02 +00:00
github-actions[bot] e2a7405584 Dead link check [2026-05-21] 2026-05-21 06:34:33 +00:00
github-actions[bot] c0b7b67e4e Auto update [2026-05-21] 2026-05-21 00:41:50 +00:00
github-actions[bot] f5d9879e68 Update tables [2026-05-20] 2026-05-20 12:23:24 +00:00
anon (hello) c32767fdc5 Edit Jujutsu Kaisen Phantom Parade (data_001.jsonl) 2026-05-20 12:23:14 +00:00
github-actions[bot] 613c09d9a6 Top online [2026-05-20 04:39] 2026-05-20 04:39:45 +00:00
github-actions[bot] 478540a6fa Update tables [2026-05-20] 2026-05-20 04:00:08 +00:00
anon (hello) fdca367589 Edit ヘブンバーンズレッド (data_001.jsonl) 2026-05-20 03:59:58 +00:00
poli0981andClaude Opus 4.7 7acdb87ea9 v3.2.6: mobile hotfix — AC Index table scroll + game card thumbnail fallback (#81)
Two mobile-viewport regressions from the v3.2.5 responsive overhaul.

- **AC Index table**: `web/src/pages/AntiCheatList.tsx` per-family table wrapper was `overflow-hidden`, clipping the right-hand columns on a 390 px viewport with no scroll affordance. Changed to `overflow-x-auto` — table scrolls horizontally when wider than the card, scrollbar hidden when it fits.
- **Mobile card thumbnail**: `web/src/components/games/table/MobileGameCards.tsx` `<img>` loads the `capsule_184x69.jpg` variant via `headerToCapsule()`; Steam's CDN lacks that variant for some games → blank thumbnail. Ported the `onError` fallback from the desktop column (`table/columns.tsx`) — swaps `src` to the original `header.jpg` on 404, guarded against an infinite loop. `GameDetailDrawer` uses `g.header_image` directly, hence images always showed once a card was tapped.
- Version bump `1.2.5` → `1.2.6` (`web/package.json`, `web/src-tauri/Cargo.toml` + Cargo.lock, `tauri.conf.json`). README badge `3.2.5` → `3.2.6`.

Verification: `npm run build` (2418 modules), `cargo check` (v1.2.6 compiles).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 08:44:09 +07:00
852 changed files with 743875 additions and 23823 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
-64
View File
@@ -1,64 +0,0 @@
name: ➕ Add New Games
description: Suggest new free-to-play games (max 15)
title: "[Add Games] "
labels: [ "add-game" ]
body:
- type: markdown
attributes:
value: |
Thanks for adding games! I'll check links (though lazy, no guarantee :)))
- type: dropdown
id: count
attributes:
label: How many games? (max 15)
options:
- "1"
- "2"
- "3"
- "4"
- "5"
- "6"
- "7"
- "8"
- "9"
- "10"
- "11"
- "12"
- "13"
- "14"
- "15"
validations:
required: true
- type: textarea
id: links
attributes:
label: Steam links (required – one per line pls)
description: Write 2 links on one line? Your loss bro :))
placeholder: |
https://store.steampowered.com/app/123456/Game_Name/
https://store.steampowered.com/app/789012/Another_Game/
validations:
required: true
- type: textarea
id: reason
attributes:
label: Why add these? (optional)
description: e.g., "Game hay", "Free forever", "Noob friendly Easy mode"
- type: textarea
id: notes
attributes:
label: Notes for table? (optional)
description: e.g., "Toxic community", "Grind heavy but fair", "Safe y"
- type: checkboxes
id: terms
attributes:
label: Final check
description: Spam/off-topic links ignored by default. Good luck :))
options:
- label: I agree – these are real F2P Steam games
required: true
+20 -18
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
@@ -16,9 +18,11 @@ body:
label: Where did you see it?
description: Helps me figure out which layer to look at first.
options:
- "Web app — https://poli0981.github.io/free-steam-games-list/"
- "GitHub markdown — games/*.md"
- "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)"
@@ -31,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
@@ -50,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
@@ -61,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
@@ -72,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
@@ -85,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
+110
View File
@@ -0,0 +1,110 @@
# NOTE: committing this file REPLACES the Dependabot configuration currently
# set through repo settings.
#
# web/worker/ and web/admin/ need no entry of their own: they are built from
# web/package.json, which the /web entry below covers.
version: 2
updates:
# ── Frontend ──────────────────────────────────────────────────────────────
- package-ecosystem: npm
directory: /web
schedule:
interval: weekly
day: monday
open-pull-requests-limit: 10
groups:
# Collapses the long tail of transitive advisories (brace-expansion,
# fast-uri, nanoid, postcss, browserslist, …) into ONE PR instead of
# one per package, which is what produced the current alert backlog.
npm-security:
applies-to: security-updates
patterns: ['*']
npm-minor-patch:
applies-to: version-updates
update-types: [minor, patch]
radix:
applies-to: version-updates
patterns: ['@radix-ui/*']
tanstack:
applies-to: version-updates
patterns: ['@tanstack/*']
tauri-js:
applies-to: version-updates
patterns: ['@tauri-apps/*']
ignore:
# Framework majors are migrations with their own staged PRs, not
# 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'
update-types: [version-update:semver-major]
- dependency-name: svelte
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]
- 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]
# ── Desktop / Android shell ───────────────────────────────────────────────
- package-ecosystem: cargo
directory: /web/src-tauri
schedule:
interval: weekly
day: monday
open-pull-requests-limit: 5
groups:
cargo-security:
applies-to: security-updates
patterns: ['*']
cargo-minor-patch:
applies-to: version-updates
update-types: [minor, patch]
# ── Python pipeline ───────────────────────────────────────────────────────
# requirements.txt and requirements-test.txt pin every package, transitive
# ones included, with the sha256 of each file; an update must bring the new
# hashes too, and CI installs with --require-hashes, so a PR whose hashes
# are wrong fails python-tests instead of reaching a data job.
- package-ecosystem: pip
directory: /
schedule:
interval: weekly
day: monday
open-pull-requests-limit: 5
groups:
pip-all:
patterns: ['*']
# ── GitHub Actions ────────────────────────────────────────────────────────
- package-ecosystem: github-actions
directory: /
schedule:
interval: weekly
day: monday
open-pull-requests-limit: 5
groups:
actions-all:
patterns: ['*']
ignore:
# 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
update-types: [version-update:semver-major]
+39
View File
@@ -0,0 +1,39 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Moved — Steam F2P Tracker</title>
<link rel="canonical" href="https://free-steam-games.win/">
<meta name="robots" content="noindex, follow">
<style>
body{margin:0;min-height:100vh;display:grid;place-items:center;background:#0b0e14;color:#e8eef7;
font-family:Inter,system-ui,sans-serif;text-align:center;padding:24px}
.card{max-width:460px}
h1{font-size:20px;margin:.5em 0}
p{font-size:14px;color:#98a4b8;line-height:1.6}
a.btn{display:inline-block;margin-top:18px;padding:9px 22px;border-radius:10px;
background:#22a3f1;color:#06121e;text-decoration:none;font-size:14px;font-weight:600}
</style>
</head>
<body>
<div class="card">
<h1>This site has moved</h1>
<p>Steam F2P Tracker now lives at <strong>free-steam-games.win</strong>.</p>
<p id="fallback">Redirecting…</p>
<a class="btn" href="https://free-steam-games.win/">Go to the new site</a>
</div>
<script>
// GitHub Pages cannot issue a 301, so carry the deep link across in JS.
// A meta-refresh would drop the #/... fragment, which is exactly the part
// worth preserving: every old link into this app was a hash route.
(function () {
var hash = location.hash || "";
var path = hash.replace(/^#\/?/, "");
var target = "https://free-steam-games.win/" + (path ? "#/" + path : "");
try { location.replace(target); }
catch (e) { document.getElementById("fallback").textContent = "Open the link below."; }
})();
</script>
</body>
</html>
+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
@@ -19,7 +19,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Resolve release + create Discussion
uses: actions/github-script@v8
uses: actions/github-script@v9
env:
# Slug of the discussion category to post into. The category must
# already exist on the repo (Settings → General → Features →
@@ -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');
-19
View File
@@ -1,19 +0,0 @@
name: Anti-Cheat List
on:
# Weekly: every Sunday at 06:00 UTC. The underlying anti_cheat field is
# user-edited and rarely changes, so a daily rebuild would be noise.
schedule: [{cron: '0 6 * * 0'}]
workflow_dispatch:
permissions: {contents: write}
concurrency:
group: data-write
cancel-in-progress: false
jobs:
generate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with: {token: '${{ secrets.GH_TOKEN }}'}
- uses: actions/setup-python@v5
with: {python-version: '3.12'}
- run: chmod +x ./bash/anti_cheat.sh && ./bash/anti_cheat.sh
+138
View File
@@ -0,0 +1,138 @@
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 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.
on:
schedule:
# Sundays 17:30 UTC -- a different day AND a different hour from the daily
# discovery run (05:00), because both draw on the same per-IP Steam budget.
- cron: '30 17 * * 0'
workflow_dispatch:
inputs:
year:
description: 'Release year to sweep'
required: true
quarter:
description: 'Quarter (1-4). Leave blank to sweep the whole year.'
required: false
default: ''
limit:
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
required: false
default: false
# The window the SCHEDULED run sweeps. Dispatch runs use their own inputs.
#
# Bump this as windows complete: the job prints "candidates: N" at the end, and
# a window is done when a re-run reports 0. Working newest-first keeps the most
# relevant games arriving first. When you reach the end of the backlog, delete
# this workflow rather than leaving it grinding over swept ground.
env:
SWEEP_YEAR: '2026'
SWEEP_QUARTER: '2'
permissions:
contents: read
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. `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:
runs-on: ubuntu-latest
timeout-minutes: 90
steps:
- uses: actions/checkout@v6
- uses: actions/setup-python@v6
with:
python-version: '3.15'
- name: Assert discovery cannot write the dataset
run: |
if grep -nE '\b(save_main|save_jsonl|clear_temp|fetch_full)\b' \
scripts/discover_new.py scripts/backfill_discover.py; then
echo "::error::A discovery script imports a dataset-writing helper."
echo "Discovery must only PROPOSE candidates to the review queue."
exit 1
fi
echo "OK: no dataset-writing helpers referenced."
- name: Check ingest credentials
env:
WORKER_BASE_URL: ${{ secrets.WORKER_BASE_URL }}
CF_ACCESS_CLIENT_ID: ${{ secrets.CF_ACCESS_CLIENT_ID }}
CF_ACCESS_CLIENT_SECRET: ${{ secrets.CF_ACCESS_CLIENT_SECRET }}
run: |
missing=0
for v in WORKER_BASE_URL CF_ACCESS_CLIENT_ID CF_ACCESS_CLIENT_SECRET; do
if [ -z "${!v}" ]; then echo "::error::missing secret $v"; missing=1; fi
done
if [ "$missing" = "1" ]; then
echo "See docs/ADMIN.md for the Access service token setup."
exit 1
fi
- run: |
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
- name: Backfill
env:
WORKER_BASE_URL: ${{ secrets.WORKER_BASE_URL }}
CF_ACCESS_CLIENT_ID: ${{ secrets.CF_ACCESS_CLIENT_ID }}
CF_ACCESS_CLIENT_SECRET: ${{ secrets.CF_ACCESS_CLIENT_SECRET }}
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
# apply. Resolved in shell, NOT with an expression fallback in the env
# block above: `year` is required on dispatch but `quarter` is
# deliberately blankable, and a fallback cannot tell "blank, meaning
# whole year" from "absent, meaning use the default" -- it would
# silently narrow an explicit whole-year request to SWEEP_QUARTER.
#
# (Actions also evaluates expression syntax inside `run:` comments, so
# writing the rejected form out here would itself break the file.)
if [ -z "$YEAR" ]; then
YEAR="$SWEEP_YEAR"
QUARTER="$SWEEP_QUARTER"
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 --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
-202
View File
@@ -1,202 +0,0 @@
# Place this file at .github/workflows/bot-ingest.yml in the steam-f2p-tracker repo.
#
# Triggered by telegram-scraper-bot via workflow_dispatch.
# Required repository secrets:
# - STEAM_API_KEY (existing)
# - TELEGRAM_BOT_TOKEN (new — same token the bot uses)
name : Bot Ingest
on :
workflow_dispatch :
inputs :
links :
description : "Newline-separated Steam URLs"
required : true
chat_id :
description : "Telegram chat ID for callback"
required : true
message_id :
description : "Telegram message ID to edit"
required : true
permissions :
contents : write
# Share `data-write` group with all other workflows that push to data/ —
# prevents commit conflicts on shards. cancel-in-progress=false so we don't
# drop legitimate work.
concurrency :
group : data-write
cancel-in-progress : false
jobs :
ingest :
runs-on : ubuntu-latest
timeout-minutes : 30
steps :
-
uses : actions/checkout@v4
-
uses : actions/setup-python@v5
with :
python-version : "3.12"
-
name : Install deps
run : pip install --quiet requests
-
name : Append links to temp_info.jsonl
env :
LINKS : ${{ inputs.links }}
run : |
python <<'PY'
import json, os, pathlib
path = pathlib.Path("scripts/temp_info.jsonl")
path.parent.mkdir(parents=True, exist_ok=True)
added = 0
with path.open("a", encoding="utf-8") as f:
for line in os.environ["LINKS"].splitlines():
line = line.strip()
if not line:
continue
f.write(json.dumps({"link": line}, ensure_ascii=False) + "\n")
added += 1
print(f"Appended {added} link(s) to {path}")
PY
-
name : Run ingest_new.py
id : ingest
env :
STEAM_API_KEY : ${{ secrets.STEAM_API_KEY }}
run : |
set -o pipefail
python scripts/ingest_new.py 2>&1 | tee /tmp/ingest.log
# Capture the summary line printed by ingest_new.py
# Format: "Added: N | Dup: N | Bad: N | Net: N"
summary=$(grep -E "^Added:" /tmp/ingest.log | tail -n 1 || true)
if [ -z "$summary" ]; then
summary="(no summary line found in output)"
fi
# Capture total games line
total=$(grep -E "^Total:" /tmp/ingest.log | tail -n 1 || true)
# Multi-line output via heredoc syntax
{
echo "summary<<EOF"
echo "$summary"
[ -n "$total" ] && echo "$total"
echo "EOF"
} >> "$GITHUB_OUTPUT"
-
name : Commit changes
id : commit
run : |
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data/ scripts/temp_info.jsonl scripts/removed_games.jsonl 2>/dev/null || true
if git diff --staged --quiet; then
echo "committed=false" >> "$GITHUB_OUTPUT"
echo "No changes to commit."
else
git commit -m "bot-ingest: run ${{ github.run_id }}"
git push
echo "committed=true" >> "$GITHUB_OUTPUT"
fi
-
name : Notify Telegram (success)
if : success()
env :
BOT_TOKEN : ${{ secrets.TELEGRAM_BOT_TOKEN }}
CHAT_ID : ${{ inputs.chat_id }}
MSG_ID : ${{ inputs.message_id }}
SUMMARY : ${{ steps.ingest.outputs.summary }}
COMMITTED : ${{ steps.commit.outputs.committed }}
RUN_URL : ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
run : |
python <<'PY'
import os, urllib.request, urllib.parse, json
summary = os.environ.get("SUMMARY", "(no summary)")
committed = os.environ.get("COMMITTED", "false") == "true"
run_url = os.environ["RUN_URL"]
status = "✅" if committed else "ℹ️"
commit_line = "Committed to repo." if committed else "No changes (all duplicates / network errors)."
text = (
f"{status} *Steam ingest done*\n\n"
f"```\n{summary}\n```\n"
f"{commit_line}\n\n"
f"[View workflow run]({run_url})"
)
payload = urllib.parse.urlencode({
"chat_id": os.environ["CHAT_ID"],
"message_id": os.environ["MSG_ID"],
"parse_mode": "Markdown",
"text": text,
}).encode()
url = f"https://api.telegram.org/bot{os.environ['BOT_TOKEN']}/editMessageText"
req = urllib.request.Request(url, data=payload)
try:
with urllib.request.urlopen(req, timeout=30) as resp:
print(f"Telegram callback: HTTP {resp.status}")
except Exception as e:
print(f"Telegram callback failed: {e}")
# Don't fail the workflow — the ingest itself succeeded
PY
-
name : Notify Telegram (failure)
if : failure()
env :
BOT_TOKEN : ${{ secrets.TELEGRAM_BOT_TOKEN }}
CHAT_ID : ${{ inputs.chat_id }}
MSG_ID : ${{ inputs.message_id }}
RUN_URL : ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
run : |
python <<'PY'
import os, urllib.request, urllib.parse
text = (
"❌ *Steam ingest failed*\n\n"
f"[View workflow run]({os.environ['RUN_URL']})"
)
payload = urllib.parse.urlencode({
"chat_id": os.environ["CHAT_ID"],
"message_id": os.environ["MSG_ID"],
"parse_mode": "Markdown",
"text": text,
}).encode()
url = f"https://api.telegram.org/bot{os.environ['BOT_TOKEN']}/editMessageText"
req = urllib.request.Request(url, data=payload)
try:
with urllib.request.urlopen(req, timeout=30) as resp:
print(f"Telegram callback: HTTP {resp.status}")
except Exception as e:
print(f"Telegram callback failed: {e}")
PY
-
name : Edit Telegram message with run URL
if : always()
run : |
curl -sS -X POST "https://api.telegram.org/bot${{ secrets.BOT_TOKEN }}/editMessageText" \
-d chat_id=${{ inputs.chat_id }} \
-d message_id=${{ inputs.message_id }} \
--data-urlencode "text=$(cat result.txt)
🔗 https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-20
View File
@@ -1,20 +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
with : { token : '${{ secrets.GH_TOKEN }}' }
-
uses : actions/setup-python@v6
with : { python-version : '3.12' }
-
run : chmod +x ./bash/dead_links.sh && ./bash/dead_links.sh
+96
View File
@@ -0,0 +1,96 @@
name: Check Overrides
# Human edits live in data/overrides/<appid>.json and are re-applied by
# save_main() on every write to data/. A malformed or invalid override is
# SKIPPED at apply time rather than raised - deliberately, so one bad file
# cannot abort a two-hour scrape - which means a typo would otherwise fail
# silently and the edit would simply never take effect. This is the check that
# makes that silence loud.
on:
pull_request:
paths:
- 'data/overrides/**'
- 'scripts/core/overrides.py'
- 'scripts/edit_game.py'
# The Worker mirrors validate_value() and the file formatting. This
# workflow did not trigger on it, so "change one, change the other" had
# no enforcement in either direction.
- 'web/worker/routes/edit.ts'
- 'web/worker/lib/override-doc.ts'
# The blocklist is the same kind of standing human instruction, with the
# same two writers (/admin and a CLI) that must produce identical bytes.
- 'data/blocklist.jsonl'
- 'scripts/core/blocklist.py'
- 'scripts/delete_game.py'
- 'web/shared/removal.ts'
- 'scripts/tests/fixtures/blocklist_golden.jsonl'
- '.github/workflows/check-overrides.yml'
push:
branches: [main]
paths:
- 'data/overrides/**'
- 'scripts/core/overrides.py'
- 'scripts/edit_game.py'
# The Worker mirrors validate_value() and the file formatting. This
# workflow did not trigger on it, so "change one, change the other" had
# no enforcement in either direction.
- 'web/worker/routes/edit.ts'
- 'web/worker/lib/override-doc.ts'
# The blocklist is the same kind of standing human instruction, with the
# same two writers (/admin and a CLI) that must produce identical bytes.
- 'data/blocklist.jsonl'
- 'scripts/core/blocklist.py'
- 'scripts/delete_game.py'
- 'web/shared/removal.ts'
- 'scripts/tests/fixtures/blocklist_golden.jsonl'
- '.github/workflows/check-overrides.yml'
workflow_dispatch:
permissions:
contents: read
concurrency:
# NOT data-write: this reads the dataset and writes nothing, so queueing it
# behind the long data jobs would delay the feedback for no reason.
group: check-overrides-${{ github.ref }}
cancel-in-progress: true
jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-python@v6
with:
python-version: '3.15'
- run: |
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
- name: Validate every override
run: python scripts/edit_game.py --check
# The other half of the mirror: assert the Worker reproduces the exact
# bytes Python writes. Round-trips the real committed override files, so
# a formatting change on either side fails here.
- uses: actions/setup-node@v7
with:
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
- name: Install web deps
working-directory: web
# No lifecycle scripts, as in web-ci.yml (which says why that is safe).
run: npm ci --ignore-scripts
- name: Validate the blocklist
# A line load_blocklist() cannot honour blocks nothing - silently.
run: python scripts/delete_game.py --check
# `npm test -- <file>`, never `npx vitest`: npx may fetch a package that
# is not in the lockfile.
- name: Assert CLI/Worker override parity
working-directory: web
run: npm test -- worker/lib/override-doc.test.ts
- name: Assert CLI/Worker blocklist parity
# web-ci only runs for web/**; a Python-only change to the line format
# must fail somewhere too.
working-directory: web
run: npm test -- shared/removal.test.ts
+10 -1
View File
@@ -21,6 +21,8 @@ on:
- '**/*.tsx'
- '**/*.js'
- '**/*.jsx'
- '**/*.mjs'
- '**/*.cjs'
- '**/*.rs'
- 'requirements.txt'
- 'package.json'
@@ -41,6 +43,8 @@ on:
- '**/*.tsx'
- '**/*.js'
- '**/*.jsx'
- '**/*.mjs'
- '**/*.cjs'
- '**/*.rs'
schedule:
- cron: '0 14 * * 1'
@@ -69,8 +73,13 @@ 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
+21 -31
View File
@@ -1,11 +1,23 @@
name: Deploy Web (GitHub Pages)
# This no longer deploys the app. The site moved to Cloudflare at
# free-steam-games.win, and the app is built with base "/", so serving it from
# the /free-steam-games-list/ Pages subpath produces a blank page — every asset
# 404s. Rather than leave that live, Pages now serves a redirect.
#
# GitHub Pages cannot return a 301, so the redirect is client-side and
# deliberately carries the #/... fragment across; old links into the app were
# all hash routes.
#
# Once inbound traffic has drained, delete this workflow, delete
# notify-deploy.yml (it listens for this workflow by name), and set
# Settings -> Pages -> Source to None.
on:
push:
branches: [main]
paths:
- 'web/**'
- 'data/**'
- '.github/pages-tombstone/**'
- '.github/workflows/deploy-pages.yml'
workflow_dispatch:
@@ -19,40 +31,18 @@ concurrency:
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-latest
defaults:
run:
working-directory: web
steps:
- uses: actions/checkout@v5
- uses: actions/setup-node@v5
with:
node-version: '24'
cache: 'npm'
cache-dependency-path: web/package-lock.json
- name: Install
run: npm ci || npm install
- name: Type check
run: npm run typecheck
- name: Build
run: npm run build
- name: Upload Pages artifact
uses: actions/upload-pages-artifact@v4
with:
path: web/dist
deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v6
- name: Upload redirect page
uses: actions/upload-pages-artifact@v5
with:
path: .github/pages-tombstone
- id: deployment
uses: actions/deploy-pages@v5
+102
View File
@@ -0,0 +1,102 @@
name: Discover New Games
# Finds newly-released free-to-play titles on Steam and PROPOSES them to the
# admin review queue in D1. It cannot add a game to the catalogue: publication
# is decided under /admin - by a reviewer, or by the auto-approve rule a
# reviewer turned on there (off by default, capped per day) - and is still
# only a request that ingest_new.py checks game by game.
#
# The `permissions: contents: read` below is the enforcement, not a formality.
# Every other data workflow in this repo declares `contents: write`; this one
# must not, because a discovery job that could also commit would collapse the
# propose/approve split that the whole ingest design rests on.
on:
schedule:
# 05:00 UTC. Deliberately clear of `Auto Update JSON Data` (00:00) and of
# Backfill Discovery (Sundays 17:30) so the three never contend for the
# Steam rate budget, which is per-IP and therefore shared across runners.
- cron: '0 5 * * *'
workflow_dispatch:
inputs:
max_pages:
description: 'Search pages to walk (100 rows each). Use ~10 for the initial catch-up sweep.'
required: false
default: '5'
dry_run:
description: 'Find candidates but do not POST them'
type: boolean
required: false
default: false
permissions:
contents: read
concurrency:
# Its own group, NOT `data-write`: this job writes nothing to the repo, so
# 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:
runs-on: ubuntu-latest
timeout-minutes: 60
steps:
- uses: actions/checkout@v6
- uses: actions/setup-python@v6
with:
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
# violated rather than at the point the token is refused -- and it names
# the reason, which a 403 from git does not.
- name: Assert discovery cannot write the dataset
run: |
if grep -nE '\b(save_main|save_jsonl|clear_temp|fetch_full)\b' \
scripts/discover_new.py scripts/backfill_discover.py; then
echo "::error::A discovery script imports a dataset-writing helper."
echo "Discovery must only PROPOSE candidates to the review queue."
exit 1
fi
echo "OK: no dataset-writing helpers referenced."
- name: Check ingest credentials
env:
WORKER_BASE_URL: ${{ secrets.WORKER_BASE_URL }}
CF_ACCESS_CLIENT_ID: ${{ secrets.CF_ACCESS_CLIENT_ID }}
CF_ACCESS_CLIENT_SECRET: ${{ secrets.CF_ACCESS_CLIENT_SECRET }}
run: |
missing=0
for v in WORKER_BASE_URL CF_ACCESS_CLIENT_ID CF_ACCESS_CLIENT_SECRET; do
if [ -z "${!v}" ]; then echo "::error::missing secret $v"; missing=1; fi
done
if [ "$missing" = "1" ]; then
echo "Create a Cloudflare Access service token named 'f2p-discovery'"
echo "and an Access application covering /api/ingest/*, then add the"
echo "client id/secret as repository secrets. See docs/ADMIN.md."
exit 1
fi
- run: |
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
- name: Discover
env:
WORKER_BASE_URL: ${{ secrets.WORKER_BASE_URL }}
CF_ACCESS_CLIENT_ID: ${{ secrets.CF_ACCESS_CLIENT_ID }}
CF_ACCESS_CLIENT_SECRET: ${{ secrets.CF_ACCESS_CLIENT_SECRET }}
run: |
python scripts/discover_new.py \
--max-pages "${{ inputs.max_pages || '5' }}" \
${{ inputs.dry_run && '--dry-run' || '' }}
-51
View File
@@ -1,51 +0,0 @@
name : Ingest from Issue
on :
issues : { types : [ opened ] }
permissions : { contents : write, issues : write }
concurrency :
group : data-write
cancel-in-progress : false
jobs :
ingest :
if : contains(github.event.issue.title, '[add-game]')
runs-on : ubuntu-latest
steps :
-
uses : actions/checkout@v4
with : { token : '${{ secrets.GH_TOKEN }}' }
-
uses : actions/setup-python@v5
with : { python-version : '3.12' }
-
uses : actions/github-script@v7
with :
script : |
const body = context.payload.issue.body || '';
const m = body.match(/```json\s*([\s\S]*?)\s*```/);
if (!m) { core.setFailed('No JSON block'); return; }
const fs = require('fs');
fs.writeFileSync('scripts/temp_info.jsonl', m[1].trim() + '\n');
-
run : |
pip install --quiet requests
python scripts/ingest_new.py
python scripts/generate_tables.py
env : { STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}' }
-
run : |
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add .
git diff --staged --quiet && echo "No changes" || git commit -m "Ingest #${{ github.event.issue.number }}" && git push
-
uses : actions/github-script@v7
with :
script : |
const n = context.payload.issue.number;
const fs = require('fs');
let t = ''; try { t = fs.readFileSync('scripts/temp_info.jsonl','utf8').trim(); } catch {}
const ok = t === '';
await github.rest.issues.createComment({owner:context.repo.owner,repo:context.repo.repo,issue_number:n,
body: ok ? '✅ Game added!' : '❌ Ingest failed or skipped. Check logs.'});
await github.rest.issues.update({owner:context.repo.owner,repo:context.repo.repo,issue_number:n,
state:'closed', labels:['add-game', ok ? 'completed' : 'rejected']});
+28 -3
View File
@@ -1,21 +1,46 @@
name : Ingest New Game Links
on :
push : { paths : [ 'scripts/temp_info.jsonl' ] }
# branches filter is REQUIRED: without it every v*/desktop-v* tag push
# matches the paths filter (tag pushes compare against an empty base),
# 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), so one run does both.
push : { branches : [ main ], paths : [ 'scripts/temp_info.jsonl', 'data/blocklist.jsonl' ] }
# 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
with : { token : '${{ secrets.GH_TOKEN }}' }
# The tip of main when the job STARTS, not the commit that triggered
# it. A run that waited behind a long data job would otherwise work on
# shards that job has since rewritten, and its push would fail to
# rebase.
with : { ref : main }
-
uses : actions/setup-python@v6
with : { python-version : '3.14' }
with : { python-version : '3.15' }
-
run : chmod +x ./bash/ingest.sh && ./bash/ingest.sh
env : { STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}' }
+20 -20
View File
@@ -19,23 +19,32 @@ 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/setup-python@v5
- 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:
python-version: '3.11'
ref: main
- uses: actions/setup-python@v6
with:
python-version: '3.15'
cache: 'pip'
cache-dependency-path: requirements.txt
- run: pip install -r requirements.txt
- run: |
pip install --require-hashes --only-binary :all: -r requirements.txt
- name: Mark dead games
env:
@@ -49,19 +58,10 @@ jobs:
- name: Commit changes
if: ${{ inputs.dry_run != true }}
# Through commit_push.sh like every other data job: it rebases and
# retries when main moved during the run (a bare `git push` threw the
# run away), and it commits the whole tree, so scripts/removed_games.jsonl
# goes with the shards when save_main() applied a removal
# (scripts/core/blocklist.py).
run: |
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data/ scripts/dead_games.log
if git diff --cached --quiet; then
echo "No changes."
else
git commit -m "chore(data): mark dead games"
git push
fi
- name: Trigger markdown rebuild
if: ${{ inputs.dry_run != true && success() }}
run: gh workflow run "Generate Markdown Tables"
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
bash ./bash/commit_push.sh "chore(data): mark dead games"
+9 -4
View File
@@ -11,17 +11,22 @@ on:
# notifications silently break.
workflows:
- "Auto Update JSON Data"
- "Generate Markdown Tables"
- "Top Online Leaderboard"
- "Update Reviews"
- "Check Dead Links"
- "Purge Unhealthy Games"
- "Ingest New Game Links"
- "Ingest from Issue"
- "Bot Ingest"
- "Force Re-fetch All (v2.1 Schema)"
- "Mark Dead Games"
- "Check Overrides"
- "Discover New Games"
- "Backfill Discovery (TEMPORARY)"
- "CodeQL"
- "Web CI"
- "Python Tests"
- "Daily Snapshot"
- "Top Offline Leaderboard"
- "Refresh Store Data"
- "Refresh All-Time Peaks"
types: [completed]
# REQUIRED: declare permissions matching the reusable workflow's needs.
+28 -4
View File
@@ -1,21 +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
with : { token : '${{ secrets.GH_TOKEN }}' }
# 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.14' }
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 }}
+43
View File
@@ -0,0 +1,43 @@
name: Python Tests
# The pipeline had no tests at all. These start with the one contract a
# mistake in would silently strand every visitor on stale data: data/index.json
# (per-shard sha256, and last_updated changing only when a shard changes).
on:
pull_request:
paths: ['scripts/**', 'requirements*.txt', 'pyproject.toml', '.github/workflows/python-tests.yml']
push:
branches: [main]
paths: ['scripts/**', 'requirements*.txt', 'pyproject.toml', '.github/workflows/python-tests.yml']
workflow_dispatch:
permissions:
contents: read
concurrency:
# Reads nothing from data/ and writes nothing, so it does not join the
# data-write group.
group: python-tests-${{ github.ref }}
cancel-in-progress: true
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-python@v6
with:
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
# call for the test tools.
- name: Install the pipeline's dependencies
run: |
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
- name: Install the test tools
run: |
pip install --quiet --require-hashes --only-binary :all: -r requirements-test.txt
- name: pytest
run: python -m pytest scripts/tests -q
+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 }}
+22 -8
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,29 +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 :
token : ${{ secrets.GH_TOKEN }}
ref : main
-
name : Setup Python
uses : actions/setup-python@v6
with :
python-version : '3.14'
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
+51
View File
@@ -0,0 +1,51 @@
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 (~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, 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.
on:
schedule: [{cron: '30 19 * * *'}]
workflow_dispatch:
inputs:
backfill:
description: 'Ask SteamCharts about every game, not just today''s slice (~4 h)'
required: false
default: false
type: boolean
permissions: {contents: write}
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
refresh:
runs-on: ubuntu-latest
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.15'}
- run: chmod +x ./bash/refresh_peaks.sh && ./bash/refresh_peaks.sh
env:
PEAKS_ALL: ${{ inputs.backfill }}
JOB_BUDGET_MINUTES: ${{ inputs.backfill && '300' || '25' }}
+60
View File
@@ -0,0 +1,60 @@
name: Refresh Store Data
# The store fields update_data.py fills once and never revisits (it only
# enriches INCOMPLETE records): tags, languages and the paid-DLC flag from the
# 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 - 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 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 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 * * *'}]
workflow_dispatch:
inputs:
only:
description: 'One part only: a store group, or the anti-cheat sweep; leave empty for all'
required: false
default: ''
type: choice
options: ['', 'page', 'details', 'anticheat']
permissions: {contents: write}
concurrency:
group: data-write
cancel-in-progress: false
queue: max
jobs:
refresh:
runs-on: ubuntu-latest
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.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'
+164
View File
@@ -0,0 +1,164 @@
name: Release Android App
# Builds a signed, universal release APK and attaches it to a (draft) GitHub
# Release. Triggered by pushing an `android-v*` tag, or manually.
#
# Required repo secrets (Settings → Secrets and variables → Actions):
# ANDROID_KEYSTORE_BASE64 base64 of the release keystore (.jks):
# `base64 -w0 release.jks` (Linux/macOS) or
# `[Convert]::ToBase64String([IO.File]::ReadAllBytes("release.jks"))` (PowerShell)
# ANDROID_KEYSTORE_PASSWORD store password
# ANDROID_KEY_ALIAS key alias
# ANDROID_KEY_PASSWORD key password
# Without these, the build can't sign and this workflow fails on purpose — an
# unsigned APK can't be installed. KEEP THE KEYSTORE + PASSWORDS BACKED UP:
# every future update must be signed with the SAME key or users must uninstall.
on:
push:
tags:
- 'android-v*'
workflow_dispatch:
inputs:
tag:
# No default: a run rebuilds the tag it names and replaces that
# release's APK, so a stale default is one click from overwriting an
# old release.
description: 'Existing tag to build and release (e.g. android-v2.0.0)'
required: true
permissions:
contents: write
jobs:
build:
runs-on: ubuntu-latest
steps:
# 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@v6
with:
ref: ${{ github.event.inputs.tag || github.ref }}
# The commit actually built. On a manual run `github.sha` is main's HEAD,
# not the tag checked out above.
- name: Record the source commit
id: source
run: echo "sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
- name: Set up JDK 17
uses: actions/setup-java@v6
with:
distribution: temurin
java-version: '17'
- uses: actions/setup-node@v7
with:
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
# Third-party actions are pinned to a commit (see release-desktop.yml).
- name: Install Rust toolchain + Android targets
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # v1 (master)
with:
toolchain: stable
targets: aarch64-linux-android,armv7-linux-androideabi,i686-linux-android,x86_64-linux-android
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
with:
workspaces: 'web/src-tauri -> target'
# platform-tools only. The action's default also installs the legacy
# `tools` package, which Google has removed from the SDK repository:
# `sdkmanager tools` fails with "Failed to find package 'tools'" and the
# whole release stops before building (android-v2.0.0, 2026-09-17).
# Gradle installs the build-tools and platform it needs on its own.
- name: Set up Android SDK
uses: android-actions/setup-android@be39fa834029ff78f1a44aa3bb0819b8fc2bd8fd # v4.0.4
with:
packages: platform-tools
log-accepted-android-sdk-licenses: false
- name: Set up Android NDK
id: setup-ndk
uses: nttld/setup-ndk@ed92fe6cadad69be94a966a7ee3271275e62f779 # v1.6.0
with:
ndk-version: r27
link-to-sdk: true
local-cache: true
- name: Export NDK_HOME
run: echo "NDK_HOME=${{ steps.setup-ndk.outputs.ndk-path }}" >> "$GITHUB_ENV"
- name: Install web dependencies
working-directory: web
# Plain `npm ci`, as in web-ci.yml: build from the tested lockfile or
# not at all, and with no lifecycle scripts (web-ci.yml says why).
run: npm ci --ignore-scripts
- name: Configure release keystore
working-directory: web/src-tauri/gen/android
env:
KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
STORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}
KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}
run: |
if [ -z "$KEYSTORE_BASE64" ]; then
echo "::error::ANDROID_KEYSTORE_BASE64 secret is not set — cannot sign the release APK."
exit 1
fi
echo "$KEYSTORE_BASE64" | base64 -d > "$RUNNER_TEMP/release.jks"
# Guard against a truncated/corrupt base64 secret silently yielding
# an invalid keystore that fails opaquely later.
if [ "$(stat -c%s "$RUNNER_TEMP/release.jks")" -lt 1000 ]; then
echo "::error::Decoded keystore is suspiciously small — check the base64 secret."
exit 1
fi
{
echo "storeFile=$RUNNER_TEMP/release.jks"
echo "storePassword=$STORE_PASSWORD"
echo "keyAlias=$KEY_ALIAS"
echo "keyPassword=$KEY_PASSWORD"
} > keystore.properties
- name: Make gradlew executable
run: chmod +x web/src-tauri/gen/android/gradlew
- name: Build signed release APK
working-directory: web
# Universal APK (all 4 ABIs) — one file installs on any device. Swap to
# `--split-per-abi` if smaller per-architecture downloads are preferred.
run: npm run tauri -- android build --apk
- name: Publish APK to GitHub Release
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 }}
draft: true
prerelease: false
fail_on_unmatched_files: true
files: web/src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
body: |
Android build of the F2P Tracker — the same app as the desktop build
and https://free-steam-games.win, packaged as a sideloadable APK.
**Install**
1. Download `app-universal-release.apk`.
2. On your phone, allow "Install unknown apps" for your browser/file
manager when prompted, then open the APK.
3. Updates: install a newer APK over the top — same signing key, so no
uninstall needed.
**Requires Android 11 (API 30) or newer** — older devices are blocked
at install (`INSTALL_FAILED_OLDER_SDK`). Why this floor, the devices
it was chosen on and worldwide version stats: `docs/android-support.md`.
Reads its data from free-steam-games.win (`/api/data`) and keeps the
last verified copy for offline use; no telemetry. See
`docs/DISCLAIMER.md` for accuracy caveats.
Built from commit `${{ steps.source.outputs.sha }}`.
+68 -17
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'
@@ -45,35 +48,46 @@ jobs:
wget \
file
- uses: actions/setup-node@v5
- uses: actions/setup-node@v7
with:
node-version: '24'
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
# Third-party actions are pinned to a commit, with the version in a
# comment for Dependabot: a moved tag must not reach a job holding the
# updater's signing key. rust-toolchain is pinned to a MASTER commit and
# given its toolchain explicitly - its `stable` branch is regenerated on
# top of master, so a commit of that branch can disappear.
- name: Install Rust toolchain
uses: dtolnay/rust-toolchain@stable
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # v1 (master)
with:
toolchain: stable
targets: ${{ matrix.platform == 'macos-latest' && 'aarch64-apple-darwin,x86_64-apple-darwin' || '' }}
- uses: Swatinem/rust-cache@v2
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
with:
workspaces: 'web/src-tauri -> target'
# Plain `npm ci`, as in web-ci.yml. The `|| npm install` fallback is what
# hid a lockfile conflict for a month: a release must build from exactly
# the dependencies that were tested, or not at all. No lifecycle scripts
# (web-ci.yml says why none is needed).
- name: Install web dependencies
working-directory: web
run: npm ci || npm install
run: npm ci --ignore-scripts
- name: Build Tauri app
uses: tauri-apps/tauri-action@v0
uses: tauri-apps/tauri-action@1deb371b0cd8bd54025b384f1cd735e725c4060f # v1.0.0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# Inject the updater minisign private key so artefacts are signed
# at build time. Public key is baked into tauri.conf.json. Set
# `TAURI_SIGNING_PRIVATE_KEY` (and password if used) under
# repo Settings → Secrets and variables → Actions. Empty value
# → builds still succeed but updater clients will reject the
# unsigned binaries.
# repo Settings → Secrets and variables → Actions. The secret is
# required: bundle.createUpdaterArtifacts is on, and the updater in
# every installed copy rejects an artefact its public key cannot
# verify.
TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
with:
@@ -81,19 +95,56 @@ jobs:
tagName: ${{ github.event.inputs.tag || github.ref_name }}
releaseName: 'F2P Tracker ${{ github.event.inputs.tag || github.ref_name }}'
releaseBody: |
Desktop builds of the F2P Tracker — a fixed-size 1400×900 window wrapping the same web UI deployed at https://poli0981.github.io/free-steam-games-list/.
Desktop builds of the F2P Tracker — a resizable window around the same app as https://free-steam-games.win.
**Installation**
- Windows: download the `.msi` and run.
- Windows: download the `.msi` or `-setup.exe` and run.
- macOS: download the `.dmg`, drag to Applications. Universal binary (Intel + Apple Silicon).
- Linux: `.AppImage` (run directly) or `.deb` (Debian/Ubuntu).
**Auto-update**: from v1.0 onwards the desktop app polls this Releases page on launch and offers to download + verify (minisign) the next signed build. To take updates, install via the official binaries — sideloaded copies won't see the prompt.
**Updates**: from 2.0.0 the app checks free-steam-games.win for a newer desktop release a few seconds after launch and offers to install it. The download comes from this Releases page and is verified against the app's minisign key before it installs. Publishing this draft is what makes it visible to that check.
See `docs/DISCLAIMER.md` for accuracy caveats. The desktop app reads data live from `raw.githubusercontent.com`; offline functionality matches the PWA.
The app reads its data from free-steam-games.win (`/api/data`) and keeps the last verified copy for offline use. See `docs/DISCLAIMER.md` for accuracy caveats.
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
+25
View File
@@ -0,0 +1,25 @@
name: Daily Snapshot
on:
schedule: [{cron: '0 23 * * *'}]
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 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:
# 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 -5
View File
@@ -5,16 +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
with: {token: '${{ secrets.GH_TOKEN }}'}
- 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 -5
View File
@@ -3,16 +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
with: {token: '${{ secrets.GH_TOKEN }}'}
- 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'
-18
View File
@@ -1,18 +0,0 @@
name: Generate Markdown Tables
on:
workflow_run: {workflows: ['Auto Update JSON Data'], types: [completed]}
workflow_dispatch:
permissions: {contents: write}
concurrency:
group: data-write
cancel-in-progress: false
jobs:
generate:
if: ${{ github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success' }}
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
with: {token: '${{ secrets.GH_TOKEN }}'}
- uses: actions/setup-python@v6
with: {python-version: '3.14'}
- run: chmod +x ./bash/daily.sh && ./bash/daily.sh
+13 -3
View File
@@ -3,16 +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: {token: '${{ secrets.GH_TOKEN }}'}
with: {ref: main}
- uses: actions/setup-python@v6
with: {python-version: '3.14'}
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 -3
View File
@@ -1,20 +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
with : { token : '${{ secrets.GH_TOKEN }}' }
# 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.14' }
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 }}
+120
View File
@@ -0,0 +1,120 @@
name: Web CI
# The check gate for web/. This exists because deploy-pages.yml was previously
# the ONLY thing running `npm run typecheck` — so when that workflow is deleted
# 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/**', 'sonar-project.properties']
push:
branches: [main]
paths: ['web/**', '.github/workflows/**', 'sonar-project.properties']
workflow_dispatch:
permissions:
contents: read
concurrency:
group: web-ci-${{ github.ref }}
cancel-in-progress: true
jobs:
check:
runs-on: ubuntu-latest
defaults:
run:
working-directory: web
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
# Deliberately NOT `npm ci || npm install`. That fallback is what hid the
# echarts/echarts-wordcloud peer conflict: `npm ci` failed, `npm install`
# was tried, and the step still went red only at the very end — while
# locally everyone kept a stale node_modules. A lockfile that cannot be
# installed cleanly is a failure, not something to work around.
#
# --ignore-scripts everywhere this repo runs `npm ci`: a dependency's
# install script would otherwise run with this job's token (and, in the
# release workflows, the signing keys). Three packages have one, and none
# is needed: esbuild (wrangler's) and workerd only hard-link the binary
# from their @esbuild/* and @cloudflare/workerd-* optional packages, which
# they also find without it, and fsevents is macOS file watching, which
# no build uses. The root package.json has no lifecycle scripts.
- name: Install
run: npm ci --ignore-scripts
# Covers BOTH tsconfigs. tsconfig.json only includes ["src",
# "vite.config.ts"], so before tsconfig.worker.json existed the Worker
# source would have shipped completely untyped.
- name: Type check
run: npm run typecheck
# Before the build, so a broken guard or a formatting drift in the
# override serialiser fails fast rather than after a full bundle.
- name: Test
run: npm test
- name: Build
run: npm run build
# Reads the prerendered HTML. The bugs it looks for - an unfilled
# placeholder in a meta description, a count baked in as "0", an empty
# state or the consent dialog shipped as page content - are invisible in
# dev and in unit tests, because they only exist when a page is rendered
# with no browser, no storage and no data.
- name: Verify prerendered output
run: node scripts/verify-dist.mjs --web
# Bundles the Worker and resolves every binding in wrangler.jsonc without
# deploying or needing credentials. Catches a broken config here rather
# than in the Cloudflare dashboard after a push. Through the npm script,
# not `npx`, which may fetch a package that is not in the lockfile.
- name: Worker build check
run: npm run cf:check
# knip.json is warn-only, so this reports dead code without failing the
# build. Flip the rules in knip.json to error when the backlog is clear.
- name: Unused code report
run: npm run knip
# The packaged apps are built from the same source with a different
# configuration (TAURI_ENV_PLATFORM): their own CSP flavour, no service
# worker, no manifest, no prerendered game pages. Nothing checked that build
# before a release tag, so a mistake in it surfaced only in a draft release.
# This builds the web half of it - no Rust toolchain needed - and verifies it.
tauri-flavour:
runs-on: ubuntu-latest
defaults:
run:
working-directory: web
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
node-version: '26'
cache: 'npm'
cache-dependency-path: web/package-lock.json
- name: Install
run: npm ci --ignore-scripts
- name: Build (Tauri configuration)
env:
TAURI_ENV_PLATFORM: linux
run: npm run build:desktop
- name: Verify packaged-app output
run: node scripts/verify-dist.mjs --tauri
+63 -13
View File
@@ -9,6 +9,11 @@
ehthumbs.db
Thumbs.db
*.log
# scripts/dead_games.log is a COMMITTED audit trail: appended by
# 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_games.log
*.tmp
*.temp
*.swp
@@ -22,8 +27,10 @@ Thumbs.db
*.iml
*.ipr
# VS Code
.vscode/
# VS Code. `.vscode/*` not `.vscode/`: git does not descend into an excluded
# DIRECTORY, so a negation cannot re-include a file whose parent is excluded --
# the four exceptions below were dead code.
.vscode/*
!.vscode/settings.json
!.vscode/tasks.json
!.vscode/launch.json
@@ -51,6 +58,26 @@ local.properties
.env
.env.local
.env.*.local
# .env.production / .env.development matched none of the three rules above.
.env.*
!.env.example
# Wrangler local secrets. `wrangler dev` reads GH_APP_PRIVATE_KEY -- the
# GitHub App PEM that can commit to this repo -- from here, INLINE, so the
# *.pem and *.key rules below do not cover it.
.dev.vars
.dev.vars.*
!.dev.vars.example
# Android signing keystores. web/src-tauri/TAURI.md walks you through
# `keytool -genkeypair -keystore f2p-tracker-release.jks` with a relative path
# inside gen/android/, and only keystore.properties was ignored. Losing or
# leaking this key means the Android app can never be updated again.
*.jks
*.keystore
*.p12
*.pfx
*.pem
*.key
*.cer
@@ -67,13 +94,17 @@ __pycache__/
# Virtual Environments
venv/
.venv/
env/
ENV/
# Anchored: unanchored `env/` matched web/worker/env/ at any depth, silently
# dropping Worker source. (On Windows core.ignorecase makes ENV/ match env/.)
/env/
/ENV/
.virtualenv/
# Distribution / Packaging
build/
dist/
# Distribution / Packaging. Anchored to the repo root: web/dist is covered by
# web/.gitignore, and Android build dirs by the nested gitignores that
# `tauri android init` wrote, so unanchored forms only risk hiding real source.
/build/
/dist/
*.egg-info/
*.egg
.eggs/
@@ -87,6 +118,7 @@ pip-delete-this-directory.txt
.coverage.*
htmlcov/
*.cover
coverage.xml
# Jupyter Notebook
.ipynb_checkpoints
@@ -117,6 +149,13 @@ pnpm-debug.log*
coverage/
.nyc_output/
# F2P Tracker desktop / Android app (Tauri 2 + Rust, at web/src-tauri).
# NOTE: there is no app/ directory in this repo — an earlier version of this
# block ignored app/** and described the shell as Electron. Both were wrong.
web/src-tauri/target/
web/src-tauri/gen/android/app/build/
web/src-tauri/gen/apple/build/
# ========================
# 6. MOBILE CROSS-PLATFORM
# ========================
@@ -166,16 +205,27 @@ artifacts/
# 9.CUSTOM RULES
# ========================
# Add any project-specific files or directories to ignore below
[Nn]ote.txt
[Nn]ote.md
[Nn]otes.txt
[Nn]otes.md
# Anchored: unanchored these matched docs/notes.md, docs/i18n/*/notes.md and
# anything similar -- the likeliest filename for real documentation here.
/[Nn]ote.txt
/[Nn]ote.md
/[Nn]otes.txt
/[Nn]otes.md
temp_data/
debug_info/
countdata.py
checkduplicates.py
/countdata.py
/checkduplicates.py
data.bak/
*.pre_shard
.claude/
# Wrangler working state. web/.gitignore covers web/.wrangler, but running
# wrangler from the REPO ROOT writes .wrangler/ here instead -- which is how
# .wrangler/cache/wrangler-account.json (Cloudflare account id + account email)
# reached a public repo. Unanchored so it holds at any depth.
.wrangler/
# Kotlin incremental build state from `tauri android build`.
.kotlin/
# End of .gitignore file
-10
View File
@@ -1,10 +0,0 @@
# Default ignored files
/shelf/
/workspace.xml
# Ignored default folder with query files
/queries/
# Datasource local storage ignored files
/dataSources/
/dataSources.local.xml
# Editor-based HTTP Client requests
/httpRequests/
+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).*
+22 -18
View File
@@ -1,6 +1,6 @@
# Authors
This file lives at the repo root so the author can be found without digging into the docs. The canonical handle map is also in [`username.txt`](username.txt) (machine-readable) and rendered in the web app's [About page](https://poli0981.github.io/free-steam-games-list/#/about).
This file lives at the repo root so the author can be found without digging into the docs. The canonical handle map is also in [`username.txt`](username.txt) (machine-readable) and rendered in the web app's [About page](https://free-steam-games.win/about).
## Maintainer
@@ -9,19 +9,23 @@ This file lives at the repo root so the author can be found without digging into
| Channel | Handle / URL |
|---|---|
| GitHub | [@poli0981](https://github.com/poli0981) |
| X / Twitter | [@SkullMute0011](https://x.com/SkullMute0011) |
| YouTube | [@SkullMute](https://www.youtube.com/@SkullMute) |
| Bluesky | [@skullmute0011.bsky.social](https://bsky.app/profile/skullmute0011.bsky.social) |
| Mastodon | [@skullmute1122@mastodon.social](https://mastodon.social/@skullmute1122) |
| Discord (repo) | [#general invite](https://discord.gg/2aNR3aVt) |
| Discord (game) | [#general invite](https://discord.gg/kDM9GMu5vm) |
| Steam | [profile](https://steamcommunity.com/profiles/76561199544666292/) |
| Telegram bot | [@my_skull_bot](https://t.me/my_skull_bot) — Scraper Info Game bot, see [CONTRIBUTING.md](CONTRIBUTING.md) |
| Telegram user | [@SkullMute0011](https://t.me/SkullMute0011) — DM for whitelist requests, do **not** post your Telegram ID in public channels |
| Patreon / Ko-fi | [skullmute](https://ko-fi.com/skullmute) |
| Email | `lopop05905@proton.me` (checked weekly) |
| Website | <https://poli0981.dev/> |
| Email | `contact@poli0981.dev` |
| Security | `security@poli0981.dev` |
| Privacy | `privacy@poli0981.dev` |
| Copyright / DMCA / takedown | `copyright@poli0981.dev` |
| Everything else | <https://poli0981.dev/links/> |
QR codes for the Telegram channels live in [`assets/qr/`](assets/qr/).
`poli0981.dev/links/` is the single source of truth for every other channel
— 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
vulnerability reporting first — see [`SECURITY.md`](SECURITY.md).
## Dev info
@@ -31,26 +35,26 @@ 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.
## Licensing
Everything in this repo (data, code, docs, web app) is [MIT-licensed](LICENSE) — fork freely; please keep the credit.
Code, docs and the web app are [MIT-licensed](LICENSE). The **dataset** (`data/**`, `games/**`) is licensed separately under [CC BY 4.0](LICENSE-DATA). Fork freely; please keep the credit.
+60 -507
View File
@@ -2,521 +2,74 @@
All notable changes to this awesome noob repo will be documented here.
## [v3.2.5] – 2026-05-20 (The "AC Nav + Mobile + Games Cleanup" Edition)
Every release has its own file in [`changelog/`](changelog/):
`changelog/v<major>/<major>.<minor>.x/<version>.md`, for example
[`changelog/v4/4.7.x/4.7.1.md`](changelog/v4/4.7.x/4.7.1.md). Pre-releases
go to [`changelog/beta/`](changelog/beta/) - none has been published. What is
not released yet is under [Unreleased] below; a release moves it into its own
file and adds the release to the table of its major version.
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`.
## [Unreleased]
### 🔗 AC Index sidebar navigation fix
## v4
- [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`.
## [v3.2.4] – 2026-05-20 (The "Refactor + Removed-Games + Anti-Cheat Index" Edition)
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`.
## [v3.2.3] – 2026-05-17 (The "View Commit Toast + Offline AC Lock" Edition)
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.
## [v3.2.2] – 2026-05-11 (The "Bug Fix Quartet" Edition)
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.
## [v3.2.1] – 2026-05-11 (The "Genre Cleanup" Edition)
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.
## [v3.2.0] – 2026-05-11 (The "SEO + Donate + Auto-Discussion + Health Polish + Dev Docs" Edition)
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 |
| Version | Date | Edition |
|---|---|---|
| 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` |
| [v4.7.2](changelog/v4/4.7.x/4.7.2.md) | 2026-11-17 | Steady State |
| [v4.7.1](changelog/v4/4.7.x/4.7.1.md) | 2026-11-09 | Curb Cut |
| [v4.7.0](changelog/v4/4.7.x/4.7.0.md) | 2026-11-03 | Lucky Dip |
| [v4.6.1](changelog/v4/4.6.x/4.6.1.md) | 2026-10-31 | Zip Tie |
| [v4.6.0](changelog/v4/4.6.x/4.6.0.md) | 2026-10-30 | Polyglot |
| [v4.5.1](changelog/v4/4.5.x/4.5.1.md) | 2026-10-27 | Speed Bump |
| [v4.5.0](changelog/v4/4.5.x/4.5.0.md) | 2026-10-26 | Groundwork |
| [v4.4.1](changelog/v4/4.4.x/4.4.1.md) | 2026-10-26 | Tune-Up |
| [v4.4.0](changelog/v4/4.4.x/4.4.0.md) | 2026-10-23 | Headroom |
| [v4.3.3](changelog/v4/4.3.x/4.3.3.md) | 2026-10-19 | Locksmith |
| [v4.3.2](changelog/v4/4.3.x/4.3.2.md) | 2026-10-16 | Pigeonhole |
| [v4.3.1](changelog/v4/4.3.x/4.3.1.md) | 2026-10-16 | Fair Play |
| [v4.3.0](changelog/v4/4.3.x/4.3.0.md) | 2026-10-13 | Autopilot |
| [v4.2.1](changelog/v4/4.2.x/4.2.1.md) | 2026-10-10 | Age Gate |
| [v4.2.0](changelog/v4/4.2.x/4.2.0.md) | 2026-10-03 | All-Time High |
| [v4.1.1](changelog/v4/4.1.x/4.1.1.md) | 2026-10-03 | Pocket-Sized |
| [v4.1.0](changelog/v4/4.1.x/4.1.0.md) | 2026-10-02 | Featherweight |
| [v4.0.2](changelog/v4/4.0.x/4.0.2.md) | 2026-09-29 | Right Address |
| [v4.0.1](changelog/v4/4.0.x/4.0.1.md) | 2026-09-23 | Human Check |
| [v4.0.0](changelog/v4/4.0.x/4.0.0.md) | 2026-09-17 | Rewrite |
---
## v3
## [v3.1.0] – 2026-05-09 (The "Less CI Noise, Lighter Images, Dead-Game Detection" Edition)
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 |
| Version | Date | Edition |
|---|---|---|
| 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` |
| [v3.4.3](changelog/v3/3.4.x/3.4.3.md) | 2026-09-11 | Own Domain |
| [v3.4.2](changelog/v3/3.4.x/3.4.2.md) | 2026-06-15 | Android Floor |
| [v3.4.1](changelog/v3/3.4.x/3.4.1.md) | 2026-06-14 | Chart Hotfix |
| [v3.4.0](changelog/v3/3.4.x/3.4.0.md) | 2026-06-13 | Legal Consent Gate |
| [v3.3.0](changelog/v3/3.3.x/3.3.0.md) | 2026-06-12 | Lazy-Load + Error Pages |
| [v3.2.7](changelog/v3/3.2.x/3.2.7.md) | 2026-05-22 | Coming-Soon Guard + Dead-Code Cleanup |
| [v3.2.6](changelog/v3/3.2.x/3.2.6.md) | 2026-05-20 | Mobile Hotfix |
| [v3.2.5](changelog/v3/3.2.x/3.2.5.md) | 2026-05-20 | AC Nav + Mobile + Games Cleanup |
| [v3.2.4](changelog/v3/3.2.x/3.2.4.md) | 2026-05-20 | Refactor + Removed-Games + Anti-Cheat Index |
| [v3.2.3](changelog/v3/3.2.x/3.2.3.md) | 2026-05-17 | View Commit Toast + Offline AC Lock |
| [v3.2.2](changelog/v3/3.2.x/3.2.2.md) | 2026-05-11 | Bug Fix Quartet |
| [v3.2.1](changelog/v3/3.2.x/3.2.1.md) | 2026-05-11 | Genre Cleanup |
| [v3.2.0](changelog/v3/3.2.x/3.2.0.md) | 2026-05-11 | SEO + Donate + Auto-Discussion + Health Polish + Dev Docs |
| [v3.1.0](changelog/v3/3.1.x/3.1.0.md) | 2026-05-09 | Less CI Noise, Lighter Images, Dead-Game Detection |
| [v3.0.1](changelog/v3/3.0.x/3.0.1.md) | 2026-05-07 | Desktop Actually Ships This Time |
| [v3.0.0](changelog/v3/3.0.x/3.0.0.md) | 2026-05-07 | It Has a Website Now |
---
## v2
## [v3.0.1] – 2026-05-07 (The "Desktop Actually Ships This Time" Edition)
| Version | Date | Edition |
|---|---|---|
| [v2.1.0](changelog/v2/2.1.x/2.1.0.md) | 2026-03-28 | Extension-Ready + Performance |
| [v2.0.0](changelog/v2/2.0.x/2.0.0.md) | 2026-03-26 | Finally Got Serious |
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.
## v1
### 🖥️ 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).
---
## [v3.0.0] – 2026-05-07 (The "It Has a Website Now" Edition)
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).
---
## [v2.1.0] - 2026-03-28 (The "Extension-Ready + Performance" Edition)
### 💥 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.
---
## [v2.0.0] - 2026-03-26 (The "Finally Got Serious" Edition)
### 💥 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.
---
## [v1.1.2] - 2026-01-11
- 40+ games added.
## [v1.1.1] - 2026-01-07
- 50+ games, delete/dedup scripts, CSV export, auto CSV Actions. (by [@poli0981](https://github.com/poli0981))
## [v1.1.0] - 2025-12-30 (Scale Noob Edition)
- 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 ✨
| Version | Date | Edition |
|---|---|---|
| [v1.1.3](changelog/v1/1.1.x/1.1.3.md) | 2026-01-15 | — |
| [v1.1.2](changelog/v1/1.1.x/1.1.2.md) | 2026-01-11 | — |
| [v1.1.1](changelog/v1/1.1.x/1.1.1.md) | 2026-01-07 | — |
| [v1.1.0](changelog/v1/1.1.x/1.1.0.md) | 2025-12-30 | Scale Noob |
| [v1.0.0](changelog/v1/1.0.x/1.0.0.md) | 2025-12-22 | Initial stable release |
+1364
View File
File diff suppressed because it is too large. Load diff
+7 -2
View File
@@ -8,12 +8,17 @@ 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
expect a slow reply rather than none. Security holes do not belong here — use
GitHub’s private vulnerability reporting, see [`SECURITY.md`](SECURITY.md).
This is based on the Contributor Covenant, but shortened because who reads long docs?
+77 -70
View File
@@ -2,110 +2,117 @@
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
The canonical handle list is in [`AUTHORS.md`](AUTHORS.md) at the repo root (mirror of [`username.txt`](username.txt) for human reading). Web-app version: <https://poli0981.github.io/free-steam-games-list/#/about>.
The canonical contact list is in [`AUTHORS.md`](AUTHORS.md) at the repo root
(machine-readable mirror: [`username.txt`](username.txt); the chatty version is
[`docs/Contact.md`](docs/Contact.md)). Web-app version:
<https://free-steam-games.win/about>.
Short version: **contact@poli0981.dev** for anything private,
**security@poli0981.dev** for a vulnerability (after GitHub's private
reporting, see [`SECURITY.md`](SECURITY.md)), and <https://poli0981.dev/> or
<https://poli0981.dev/links/> for everything else.
> [!WARNING]
> **Privacy first.** When sending your Telegram `user_id` (needed for the bot whitelist below), **DM the maintainer privately**. Do **not** post it in:
> - Public Discord channels (including the project's own `#general`).
> - Public Telegram groups or super-groups.
> - GitHub issues, PR comments, or commit messages.
> - Public posts on X / Bluesky / Mastodon / YouTube comments.
>
> Personal info — Telegram `user_id`, email, real name, etc. — should travel through DM only. The maintainer will not ask you for anything beyond the `user_id` for the bot.
> **Privacy first.** Issues, PR comments and commit messages are public and
> permanent — GitHub keeps them in the fork network even after deletion. Keep
> personal information (email, real name, account IDs) out of them and send it
> by email instead. The maintainer will never ask you for an account ID, a
> token, or a password: there is no whitelist to join and nothing to verify.
---
## How to contribute
### 1. Quick + lazy: open an issue (preferred for most users)
### 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:
- ➕ **Add new games** (max 15 links per issue)
- ➖ **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). The `Ingest from Issue` workflow auto-runs on the `[add-game]` template, validates, fetches Steam metadata, and closes the issue with a status comment. Other templates are reviewed manually when caffeine hits.
Blank issues are off. Every form is reviewed by hand when caffeine hits — none of them auto-run a workflow.
### 2. Sign in to the web app (for owner-equivalents)
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.
If you have repo write access:
### 2. Open a pull request (data)
1. Open <https://poli0981.github.io/free-steam-games-list/>.
2. Settings → paste a Classic GitHub PAT (scopes: `repo` + `workflow`).
3. Optionally unlock a GPG private key in Settings to sign commits → **Verified ✓** badges.
4. Add via the `Add` page (single + JSON bulk) or edit/delete via the table drawers.
Fork → branch → one of these → push → open the PR. The template has a short checklist.
The web app commits via the Git Data API + GPG signing path. The optimistic-update layer means edits show up instantly without waiting for the Fastly CDN.
**Add a game:** append store links to `scripts/temp_info.jsonl`.
### 3. Scraper Info Game bot — `@my_skull_bot` on Telegram
```jsonl
{"link": "730"}
{"link": "https://store.steampowered.com/app/570/"}
```
Quick path for users who don't want a GitHub PAT but do want to add games. The bot wraps the same `ingest-new` pipeline behind a Telegram chat.
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.
> 📖 **Full user guide:** [`telegram-scraper-bot/docs/USER_GUIDE.md`](https://github.com/poli0981/telegram-scraper-bot/blob/main/docs/USER_GUIDE.md) — command reference, edge cases, troubleshooting.
> 🔗 **Bot source repo:** <https://github.com/poli0981/telegram-scraper-bot>
> 📄 **In-repo summary:** [`docs/telegram-bot.md`](docs/telegram-bot.md) — one-page pointer + privacy notes.
**Correct a game:** add an override. It is a standing instruction in `data/overrides/<appid>.json` that every pipeline run keeps.
> **One-time setup (whitelist your Telegram `user_id`)**
>
> 1. **Find your Telegram `user_id`.** Easiest way: DM `@userinfobot` on Telegram and it replies with your numeric `user_id`. Other options: `@RawDataBot`, `@getmyid_bot`, or any "what's my Telegram ID" bot of your choice.
> 2. **DM the maintainer privately** with that `user_id`. Channels that work:
> - Telegram DM: [@SkullMute0011](https://t.me/SkullMute0011) ([QR code](assets/qr/telegram-user.png))
> - Email: `lopop05905@proton.me`
> - X DM, Discord DM (NOT public channels), or any other private channel listed in [`AUTHORS.md`](AUTHORS.md).
>
> **Strictly forbidden:** posting your `user_id` in any public channel — Discord `#general`, Telegram groups, GitHub issues, public X/Bluesky posts. The bot rejects messages from non-whitelisted IDs, so leaking the ID to randoms doesn't grant them access — but it still leaks your Telegram identity to anyone watching that channel.
> 3. Maintainer adds your `user_id` to the bot's whitelist. You only do this **once**.
```bash
python scripts/edit_game.py 730 --show
python scripts/edit_game.py 730 --set genre="FPS" --reason "Steam's genre is too coarse"
```
> **Each session (when you want to add games)**
>
> 4. **Check whether the bot is online.** The bot runs **locally on the maintainer's machine via Docker**, ~2–5 hours per day depending on availability. If it's offline, your messages will sit unread until it comes back up. There is no SLA.
> 5. **Open the bot:** [@my_skull_bot](https://t.me/my_skull_bot) ([QR code](assets/qr/telegram-bot.png)).
> 6. **Send Steam URLs** (one per line, or one per message — bot accepts either). Full URLs, short URLs, and bare appids all work:
> ```
> https://store.steampowered.com/app/730/
> 570
> https://store.steampowered.com/app/440/
> ```
> 7. **Follow the bot's prompts.** It validates URLs, fetches metadata via the Steam API, optionally lets you set manual fields (`type_game`, `genre`, `notes`, `safe`), and dispatches the `Bot Ingest` GitHub Actions workflow with your queue.
> 8. **Wait for the workflow to finish.** The bot edits its own message with the result — `✅ Steam ingest done` + summary line, or `❌ Steam ingest failed` with a link to the workflow run for debugging.
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.
The bot itself is open-source companion code (separate repo). The workflow it dispatches lives in [`.github/workflows/bot-ingest.yml`](.github/workflows/bot-ingest.yml).
**Remove a game:** add a blocklist line. The reason and the note are public.
### 4. Chrome extension (for power users)
```bash
python scripts/delete_game.py 730 --reason not_free --note "paid since 2026-11"
```
The companion [Chrome extension](https://github.com/poli0981/free-steam-games-list-extension) detects F2P games on Steam store pages and pushes pre-fetched metadata to `scripts/temp_info.jsonl`. The `Ingest New Game Links` workflow merges and dedupes on push.
Reasons: `not_free`, `not_a_game`, `duplicate`, `broken`, `inappropriate`, `other`.
### 5. Manual: fork + commit (most invasive)
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.
For code changes or bigger data edits:
### 3. Pull requests that touch code
1. Fork → branch.
2. Edit code in `scripts/` / `web/src/` / docs, or append rows to `scripts/temp_info.jsonl`:
```jsonl
{"link": "730", "type_game": "online", "safe": "y", "notes": "CS2 babyyy"}
{"link": "https://store.steampowered.com/app/570/", "genre": "MOBA"}
```
3. Push → open PR. Reviewer (= me) will look when caffeine hits.
Only two kinds are merged now:
Manual fields preserved through the ingest pipeline: `type_game`, `genre`, `anti_cheat`, `anti_cheat_note`, `is_kernel_ac`, `safe`, `notes`.
- 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.
---
## Tips for smooth contributions
- **Games must be free-to-play on Steam.** No demos, no paid-now games, no malware-flagged ones.
- **Notes / safe fields** are optional but useful. Examples: `"safe": "y"`, `"notes": "Toxic max"`, `"notes": "Grind phê Easy mode"`.
- **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 React/Vite side is TS-strict.
- **Tests:** there's no formal test suite for the data pipeline. For web changes, `npm run typecheck && npm run build` must pass.
- **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
@@ -115,4 +122,4 @@ Manual fields preserved through the ingest pipeline: `type_game`, `genre`, `anti
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 :))
+85
View File
@@ -0,0 +1,85 @@
# Data licence
This file covers the **dataset**: `data/**` and the generated tables in
`games/**`.
Source code, configuration, scripts and documentation are covered separately by
the MIT licence in [LICENSE](./LICENSE). The split exists because code and data
are different kinds of work with different constraints — MIT is a software
licence and says nothing useful about a compilation of facts.
---
## The licence
The dataset is licensed under
**[Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/)**.
You may share and adapt it, including commercially, provided you give
appropriate credit, link to the licence, and say whether you made changes.
Suggested attribution:
> Data from *Steam F2P Tracker* (github.com/poli0981/free-steam-games-list),
> CC BY 4.0.
## What this licence does and does not cover
This is the important part, and it is easy to get wrong.
**What the project can license.** The selection, curation and arrangement of
the catalogue, and the fields produced by this project's own work — the
`genre` bucketing, `type_game`, `safe`, `anti_cheat` and `is_kernel_ac`
judgements, `notes`, and the derived tables in `games/**`. That editorial
effort is the project's contribution and is what CC BY 4.0 is being applied to.
**What the project does NOT own, and therefore cannot license:**
- **`description`** — the opening of the short blurb each publisher writes for
its own Steam store page. **Truncated to 180 characters**, on a word boundary
where one is available, with an ellipsis marking the cut. 2,156 of 3,426 rows
(63%) were shortened; the rest were already under the cap and are stored
whole. No stored value exceeds 180 characters. Before truncation the
median was 213 characters and the longest 340 — long enough that the field
reproduced whole blurbs rather than quoting from them, which is the practice
this cap exists to end. What remains is a short identifying quotation so a
row is recognisable; copyright remains with the publisher, and it is
**excluded** from the CC BY grant.
- **`header_image`** — a URL pointing at publisher artwork hosted on Valve's
CDN. The dataset contains the address, never the image. The artwork itself is
the publisher's.
- **Game names, and Steam's own tag vocabulary** — names are trademarks of
their respective owners and appear here nominatively, to identify the game.
- **Anything reachable through `link`** — that is Valve's page, not ours.
**Facts are not owned by anyone.** Player counts, review percentages, release
dates, platform and language support are facts. The CC BY grant applies to this
project's compilation of them, not to the underlying facts, which nobody can
license to you.
**EU database rights.** Where a *sui generis* database right subsists in this
compilation, it is licensed on the same CC BY 4.0 terms.
## If you hold rights in something listed here
Copyright, DMCA and takedown notices — about a `description`, the artwork a
`header_image` points at, a game name, or anything else in the dataset or on the
site — go to **copyright@poli0981.dev**. Include the Steam appid or link and
what the notice concerns. Each one is read and answered by hand, by the one
person who maintains this.
## If you republish this data
Attribute the project, keep the caveats in
[docs/DISCLAIMER.md](./docs/DISCLAIMER.md) visible to your users, and do not
present the derived fields as authoritative — `genre`, `safe` and the
anti-cheat flags are one person's best effort, not an audit. Re-deriving
`description` from Steam yourself is safer than inheriting it from here.
## Not legal advice
This file was written by the maintainer, who is not a lawyer. It reflects a
good-faith engineering judgement about what can honestly be licensed, made so
that anyone reusing the data knows exactly where the boundaries are rather than
finding a blanket MIT notice over material the project never owned. If you need
certainty for a commercial use, get your own advice.
+188 -107
View File
@@ -1,75 +1,107 @@
[![Games Count](https://img.shields.io/badge/Games-1.2k%2B-green?style=flat&logo=steam)](games/all-games_part1.md)
[![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-3.2.5-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=react)](https://poli0981.github.io/free-steam-games-list/)
[![Desktop](https://img.shields.io/badge/Desktop-Tauri%202-FFC131?style=flat&logo=tauri)](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 ~1,200 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).
**v3.0.0** is the version that grew limbs. It is no longer a list. It is also:
**v4.0.0** is the version that got rebuilt from the ground up. It is still a list. It is also:
- a **React web app** at <https://poli0981.github.io/free-steam-games-list/> with a virtualised 1.2k-row table, 12 charts, fuzzy search, faceted filters, owner-gated bulk edit/delete with **GPG-signed commits**, queue-based add (single + JSON bulk), CSV/JSON export, validation badges, command palette, PWA / offline cache, **vi/en i18n**, and per-game permalinks;
- a **desktop app** (Tauri 2, fixed-size 1400 × 900 window — see Releases for Win/Mac/Linux installers);
- a **web app** at <https://free-steam-games.win/> (SvelteKit, served by a Cloudflare Worker) with a virtualised table of every game, charts, fuzzy search, filters you can link to, CSV/JSON export, a command palette, a page per game that search engines can read, **en/vi i18n**, and an installable offline mode. It is read-only for visitors: there is no sign-in;
- a **desktop app** (Tauri 2, resizable window, updates itself from GitHub Releases — Win/Mac/Linux installers);
- an **Android app** (sideloaded APK, Android 11+);
- an **admin** at `/admin`, behind Cloudflare Access: a review queue for the games the daily discovery sweep finds (approved by the maintainer, or in capped daily batches by a rule the maintainer turns on), corrections to published games, and removals;
- the same **Python pipeline** that has run daily under GitHub Actions since v1.
**Powered ~70 % by AI** (Grok for v1, Claude for v2 + the entire web/desktop layer) — code is reviewed and tested, but mistakes happen. See the [Disclaimer](docs/DISCLAIMER.md) for the specific accuracy caveats (genre best-effort, English-only assumptions, test-data leakage, unsigned-commit dev artefacts).
**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://poli0981.github.io/free-steam-games-list/> |
| 🖥️ Desktop releases | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (Win `.msi`, Mac `.dmg`, Linux `.AppImage`) |
| 📋 All games (md) | [games/all-games_part1.md](games/all-games_part1.md) (sorted by reviews) |
| 🌐 Web app | <https://free-steam-games.win/> |
| 🖥️ 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) |
| 🏷️ By genre | [games/](games/) — separate file per genre |
| 📦 Raw data | [data/data_001.jsonl](data/data_001.jsonl) + [data/data_002.jsonl](data/data_002.jsonl) (sharded JSONL) |
| 📖 Index | [games/README.md](games/README.md) |
| 🛠️ About | <https://poli0981.github.io/free-steam-games-list/#/about> (in-app) |
| 📦 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 |
| 🤖 Telegram bot | [`@my_skull_bot`](https://t.me/my_skull_bot) — Scraper Info Game bot, see [`CONTRIBUTING.md`](CONTRIBUTING.md) |
| ♿ 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 v3.0.0
### What's in v4
<details>
<summary><b>Web app at <code>poli0981.github.io/free-steam-games-list/</code></b></summary>
<summary><b>Web app at <code>free-steam-games.win/</code></b></summary>
A React/Vite SPA hosted on GitHub Pages, fetching data live from `raw.githubusercontent.com`. 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 1.2k-row table (TanStack Table + Virtual), faceted filters (genre, type, platform, status), Fuse.js fuzzy search, sortable columns including correctly-parsed release-date sorting, 50/100/200/500/all pagination, hidden scrollbar.
- **Charts** — 12 charts via Apache ECharts: KPI overview, top-online bar, genre treemap, platform donut, language heatmap, tag word cloud, anti-cheat stacked, release-year histogram, catalog-growth cumulative line, review histogram, online player tiers pie, DRM/DLC bars.
- **Edit / add / delete** (owner-only) — single edit drawer with form / JSON-editor toggle, bulk edit + delete in one signed commit, Steam-link queue (single + JSON bulk) into `scripts/temp_info.jsonl`, diff viewer, conflict-retry, optimistic local cache update so edits show up instantly without waiting for the Fastly CDN.
- **GPG signing** — paste your OpenPGP private key, unlock per-session, every edit commit gets a detached binary signature → GitHub verifies them as ✓. Multi-UID picker, idle auto-lock 5/15/30/60 min.
- **PWA** — installable, offline browse via a Workbox NetworkFirst service worker.
- **i18n** vi / en — Vietnamese + English UI, auto-detected from `navigator.language`, switchable in Settings.
- **Per-game permalinks** `/games/:appid` — share-friendly deep links into the detail drawer.
- **Activity feed** — recent commits with verified badges, filter Me / Bots / All.
- **Health page** — validation badges + workflow_dispatch buttons for the six maintenance pipelines.
- **⌘K command palette** — pages / charts / GPG lock-unlock / fuzzy game search.
- **Owner-gate** — non-owner visitors see read-only browse + charts, no edit affordances.
- **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.
Site is rebuilt and re-deployed automatically on every commit to `data/**` or `web/**`. See [`web/README.md`](web/README.md) for stack details and the per-phase changelog.
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>
<details>
<summary><b>Desktop app (Tauri 2)</b></summary>
<summary><b>Desktop and Android apps (Tauri 2)</b></summary>
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`.
- Fixed 1400 × 900 window, no maximise, no resize — keeps the layout consistent.
- Dark theme, stays in standalone mode.
- Same data path as the web app (reads `raw.githubusercontent.com` live), same offline cache.
- 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.
Built by `.github/workflows/release-desktop.yml` (matrix Win/Mac/Linux via `tauri-apps/tauri-action`), triggered by pushing a `desktop-v*` tag or a manual workflow run. Each release auto-attaches its installers as draft assets.
Built by `.github/workflows/release-desktop.yml` (matrix Win/Mac/Linux via `tauri-apps/tauri-action`) and `release-android.yml`, triggered by a `desktop-v*` / `android-v*` tag or a manual run. Each release is created as a draft.
```bash
# from web/, locally:
@@ -79,16 +111,22 @@ npm run tauri:build # release binary into web/src-tauri/target/release/bundle
</details>
<details>
<summary><b>The admin at <code>/admin</code></b></summary>
`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>
<details>
<summary><b>v2.x foundations still here</b></summary>
The Python pipeline that powered v2 is untouched and runs daily as before:
- Schema v2.2 (23 + manual fields per record), MIT-licensed, sharded data in `data/data_*.jsonl` (cap 800 records/shard, current total ~1,230) plus a `data/index.json` manifest.
- Extension-compatible: the [Chrome extension](https://github.com/poli0981/free-steam-games-list-extension) pushes pre-fetched rich data straight into `scripts/temp_info.jsonl`; the ingest workflow merges and dedupes.
- HTML scraper for accurate language tables, DLC pricing, and user tags — 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.
- 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 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>
@@ -98,14 +136,15 @@ 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 # 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/ # Auto-generated markdown tables
│ ├── all-games_part*.md # split into ~200/file
├── games/ # The two generated leaderboards
│ ├── top-online.md # live leaderboard
│ └── {genre}.md # per-genre files
│ └── top-offline.md # most-played offline-capable
│
├── scripts/ # Python data pipeline
│ ├── core/
@@ -115,45 +154,58 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
│ │ ├── fetcher.py # batch processor
│ │ ├── scraper.py # HTML page parser
│ │ └── health_checker.py # status detection
│ ├── ingest_new.py / update_data.py / generate_tables.py / …
│ ├── ingest_new.py / update_data.py / discover_new.py / …
│ └── temp_info.jsonl # ingest queue
│
├── web/ # React/Vite/Tauri front-end
│ ├── src/ # React app: pages, components, charts, i18n
│ ├── src-tauri/ # Tauri 2 desktop wrapper (Rust)
│ ├── public/ # PWA icons + manifest
│ └── dist/ # build artefacts (PWA + desktop)
├── web/ # Everything that is not the pipeline
│ ├── src/ # SvelteKit app: routes, components, charts, i18n
│ ├── admin/ # /admin review app (embedded in the Worker, never in dist/)
│ ├── worker/ # Cloudflare Worker: data + image proxy, admin API, D1 migrations
│ ├── shared/ # rules shared by the Worker and the admin app
│ ├── src-tauri/ # Tauri 2 desktop + Android shell (Rust)
│ └── static/ # icons, social image, robots.txt, _headers
│
├── docs/ # Legal + acknowledgements + contact
├── .github/workflows/ # 11 workflows: data pipeline + Pages + desktop release
└── LICENSE # MIT
├── 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
```
</details>
<details>
<summary><b>Architecture</b></summary>
<summary><b>Pipeline scripts</b></summary>
```
scripts/
├── core/
│ ├── constants.py # Config, rate limits, anti-cheat patterns
│ ├── steam_client.py # HTTP client, backoff, retry, session pooling
│ ├── data_store.py # JSONL I/O, validation, dedup, schema merge
│ ├── data_store.py # JSONL I/O, validation, dedup, save_main() + index.json
│ ├── overrides.py # Human corrections re-applied on every write
│ ├── blocklist.py # Removed games, left out of every write
│ ├── fetcher.py # Batch processor, apply_details/reviews/players/scraped
│ ├── scraper.py # Store page HTML parser (languages, DLC, tags)
│ ├── scraper.py # Store page HTML parser (languages, DLC, tags, anti-cheat)
│ ├── 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, 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
├── ingest_new.py # Add new games (health check + extension merge)
├── update_data.py # Daily full refresh
├── update_reviews.py # Reviews-only (every 2 days)
├── check_dead_links.py # HEAD-request 404/410 scanner
├── purge_unhealthy.py # Remove delisted/not-free/invalid
├── top_online.py # Live leaderboard with trends
├── generate_tables.py # Markdown tables + genre files + index
├── refetch_all.py # Force re-fetch ALL (manual only)
├── migrate_schema.py # Upgrade old records to v2.1
├── export_data.py # CSV export
└── delete_game.py # Interactive delete
├── discover_new.py # Propose new games into the /admin review queue
├── ingest_new.py # Add queued games (health check + fetch from Steam)
├── remove_games.py # Apply data/blocklist.jsonl now (runs before every ingest)
├── update_data.py # Daily: fill in incomplete records
├── 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 # Daily: every game's review summary from Steam, ~2 minutes
├── mark_dead_games.py # Flag online games with no players
├── 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, in parts (manual only)
└── delete_game.py # Remove games (blocklist) from the command line
```
</details>
@@ -162,40 +214,62 @@ scripts/
| Workflow | Trigger | What it does |
| --------------------- | -------------------------------- | --------------------------------------------------------- |
| Auto Update JSON | Daily 00:00 UTC | Full data refresh (API + HTML scrape) |
| Generate Tables | After JSON update | Regenerate all markdown tables |
| 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, 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 |
| Update Reviews | Every 2 days 06:00 UTC | Reviews-only refresh |
| 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 |
| Ingest New | On `scripts/temp_info.jsonl` push | Add new games (web app + extension queue here) |
| Ingest from Issue | On `[add-game]` issue | Parse issue → ingest → auto-close |
| Force Re-fetch | Manual only | Re-fetch ALL games |
| **Mark Dead Games** | Mon + Thu 04:30 UTC | Online + >1y + 0 players ≥14d → `is_dead=true` + 💀 note |
| **Bot Ingest** | Telegram bot dispatch | Add games via `@my_skull_bot` (whitelist required) |
| **Deploy Web** | On `web/**` or `data/**` change | Build + deploy SPA to GitHub Pages |
| **Release Desktop** | On `desktop-v*` tag | Matrix-build Tauri installers (Win/Mac/Linux) → Releases |
| **Top Offline** | 1st + 15th of month 05:00 UTC | Bi-weekly leaderboard for single-player F2P concurrents |
| **Announce Discussion** | On release `published` | Auto-create a GitHub Discussion in `Announcements` per release |
| Top Offline | 1st + 15th of month 05:00 UTC | Leaderboard for single-player F2P concurrents |
| 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 |
| 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 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` |
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 easy way — open an issue.** Pick the [Add games](.github/ISSUE_TEMPLATE/add_games.yml) template and paste up to 15 Steam links. Workflow auto-ingests, validates, health-checks, fetches metadata, and closes the issue with a status comment. The [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) templates are also pre-filled.
The repository is in [maintenance mode](#project-status): contributions are
about the **data**.
**The web app way — sign in.** If you have repo write access, sign into the web app with a Classic GitHub PAT (scopes: `repo` + `workflow`) and use the Add or Edit drawers. Optionally unlock a GPG key in Settings to get **Verified ✓** commits.
New games arrive on their own: `Discover New Games` sweeps the Steam store
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.
**The Telegram bot way — `@my_skull_bot`.** No GitHub PAT needed. One-time: DM the maintainer privately with your Telegram `user_id` (NEVER post it in public Discord / Telegram groups / GitHub issues — see [`CONTRIBUTING.md`](CONTRIBUTING.md)) → maintainer adds you to the whitelist → chat with the bot when it's online (~2–5 hrs/day, runs in Docker locally) and follow its prompts. QR codes for the bot and DM live at [`assets/qr/`](assets/qr/).
**The extension way.** The companion Chrome extension detects F2P games on Steam store pages and pushes pre-fetched metadata to `scripts/temp_info.jsonl`.
**The manual way.** Fork, append to `scripts/temp_info.jsonl`, and push:
| 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", "type_game": "online", "safe": "y", "notes": "CS2 babyyy"}
{"link": "https://store.steampowered.com/app/570/", "genre": "MOBA"}
{"link": "730"}
{"link": "https://store.steampowered.com/app/570/"}
```
Accepts a full URL, short URL, or bare appid. Optional manual fields: `type_game`, `genre`, `anti_cheat`, `anti_cheat_note`, `is_kernel_ac`, `safe`, `notes`. The ingest pipeline preserves these on top of whatever it fetches from Steam.
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.
@@ -206,7 +280,9 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
- v1 was spaghetti.
- v2.0 was organised spaghetti.
- v2.1 was spaghetti with proper seasoning. It got a scraper.
- **v3.0 is spaghetti with a website on top, a desktop app, and bilingual menus.** Still spaghetti underneath. Still a hobby.
- 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.
@@ -214,22 +290,27 @@ 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, web-app sign-in, Telegram bot flow, extension, 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 ≥ 22 / 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.
- [Telegram bot](docs/telegram-bot.md) — pointer to the external bot user guide + how it integrates with this repo.
- [DISCLAIMER](docs/DISCLAIMER.md) — accuracy caveats, no-warranty, the broke-maintainer note.
- [Terms of Use](docs/ToS.md) — usage agreement, contributions, governing law, **rules for sharing your Telegram `user_id`**.
- [EULA](docs/EULA.md) — supplemental to the MIT licence.
- [Privacy Policy](docs/PRIVACY_POLICY.md) — zero personal data collected by the site; **Telegram-bot data flow** documented separately.
- [Terms of Use](docs/ToS.md) — usage agreement, contributions, governing law.
- [EULA](docs/EULA.md) — plain-language commentary on both licences.
- [Privacy Policy](docs/PRIVACY_POLICY.md) — no accounts, no tracking cookies, no profile; what Cloudflare logs as the host, the one cookieless page-view count, and where the site is not served.
- [Deployment](docs/DEPLOYMENT.md) — how a push becomes a deploy, and how to verify or roll one back.
- [Admin setup](docs/ADMIN.md) — Cloudflare Access and the GitHub App behind `/admin`.
- [Acknowledgements](docs/ACKNOWLEDGEMENTs.md) — credits, AI assistants, third-party libraries.
- [Third-party dev tooling](docs/THIRD_PARTY.md) — dead-code / lint / audit tools + the pre-publish check suite.
- [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.
Licensed under [MIT](LICENSE) — do whatever; keep the credit if you fork. Star if you find a hidden gem ✨
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 ✨
Last auto-update: daily via GitHub Actions. Manual runs from the [Actions tab](../../actions) or the web app's Health page.
Last auto-update: daily via GitHub Actions. Manual runs from the [Actions tab](../../actions).
+97 -13
View File
@@ -1,20 +1,104 @@
# SECURITY POLICY
# Security policy
### Why does this even exist?
This repo is literally just a Markdown list of free-to-play Steam games + some JSON maybe later. No executable code, no dependencies, no backend, no user data. The biggest security risk is probably adding a game with toxic chat or aggressive microtransactions.
## What this project actually is
But hey, GitHub recommends it, and I'm paranoid enough after writing all those disclaimers.
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:
### Reporting a Vulnerability
If you somehow find a "security issue" (like a broken link, a game that's actually paid now, or a listing that offends your soul):
- Open an Issue with the title starting with "[SECURITY]" or something.
- Describe it clearly: What game? What link? Why is it bad?
- I'll fix it when I wake up from my nap (or when Grok reminds me).
- 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
- 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
**Do NOT** report fake/malware links here expecting me to click them – that's on you, bro. Steam's client is your friend.
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.
No bounties, no fame, no money – I'm broke. Just a "thanks" in the ACKNOWLEDGEMENTS if you're lucky.
There is genuinely something to attack here. Hence a real policy.
If it's actually serious (lmao unlikely), email... wait, I don't have one for this. Just open an issue.
## Reporting
Thanks for keeping the list safe-ish. Peace out.
**Use GitHub's private vulnerability reporting**, which is enabled on this
repository: *Security → Report a vulnerability*. It is private between you and
the maintainer.
If that does not work for you, email **security@poli0981.dev**. The same
address is published in [`AUTHORS.md`](AUTHORS.md),
[`docs/Contact.md`](docs/Contact.md), [`username.txt`](username.txt) and
<https://free-steam-games.win/.well-known/security.txt>.
That `security.txt` is the machine-readable version of this policy
(RFC 9116). Its `Policy` field points back at this file and its `Canonical`
field at itself; if the two ever disagree, **this file wins** and the
`security.txt` is stale.
**Please do not open a public issue for anything exploitable.** Public issues
are fine for a dead link or a game that is no longer free — those are data
problems, not security ones.
Useful report: what you did, what happened, why it matters, and how to
reproduce. A proof-of-concept URL beats a paragraph of description.
## In scope
- The Cloudflare Worker (`web/worker/**`) — the data proxy, the image proxy,
and anything reachable under `/api/*`
- 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, 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` (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; getting the update feed to offer a
file that is not this repository's release download.
## Out of scope
- Games in the list being bad, predatory, or full of microtransactions. Take it
up with the developer.
- Anything about Valve or Steam itself.
- Missing security headers with no demonstrated impact, and scanner output
pasted without a working exploit.
- Denial of service by volume.
- Getting past the website's Turnstile human check from your own browser. It is
a client-side gate on purpose: the pages are static and the catalogue API is
public by design (`docs/ToS.md` §9), so it guards nothing a script cannot
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
One person, as a hobby, in a timezone that is probably not yours. A first reply
usually within a week. Serious issues get fixed before they are discussed
publicly; minor ones may sit for a while.
No bounty programme, no money — the disclaimers about the maintainer being
broke are not a joke. Credit in `docs/ACKNOWLEDGEMENTs.md` if you want it.
## Supported versions
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.
Binary file not shown.

Before

Width:  |  Height:  |  Size: 545 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 566 B

-7
View File
@@ -1,7 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet requests
python scripts/generate_anti_cheat_list.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Anti-cheat list [$(date +'%Y-%m-%d %H:%M')]" && git push)
+43
View File
@@ -0,0 +1,43 @@
#!/bin/bash
# Commit what a data job changed, and push it even if main moved meanwhile.
#
# 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.
#
# Usage: commit_push.sh "<commit message>" [pathspec ...] (default: .)
set -euo pipefail
msg="$1"
shift
if [[ "$#" -eq 0 ]]; then
set -- .
fi
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add -- "$@"
if git diff --staged --quiet; then
echo "No changes"
exit 0
fi
git commit -m "$msg"
for attempt in 1 2 3 4 5; do
if git push; then
exit 0
fi
echo "Push rejected (attempt $attempt/5): rebasing onto origin/main and retrying"
sleep $((attempt * 10))
git pull --rebase origin main
done
echo "::error::push still rejected after 5 attempts"
exit 1
-6
View File
@@ -1,6 +0,0 @@
#!/bin/bash
set -euo pipefail
python scripts/generate_tables.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Update tables [$(date +'%Y-%m-%d')]" && git push)
-7
View File
@@ -1,7 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet requests
python scripts/check_dead_links.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Dead link check [$(date +'%Y-%m-%d')]" && git push)
+19 -5
View File
@@ -1,8 +1,22 @@
#!/bin/bash
# The ingest job, which is also the removal job.
#
# 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: 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 requests
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
python scripts/remove_games.py
python scripts/ingest_new.py
python scripts/generate_tables.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Ingest games [$(date +'%Y-%m-%d %H:%M')]" && git push)
# Name the commit after what changed: the queue file is emptied only when
# ingest_new.py processed something.
if git diff --quiet -- scripts/temp_info.jsonl; then
msg="Apply removals [$(date +'%Y-%m-%d %H:%M')]"
else
msg="Ingest games [$(date +'%Y-%m-%d %H:%M')]"
fi
bash "$(dirname "$0")/commit_push.sh" "$msg"
+2 -4
View File
@@ -1,7 +1,5 @@
#!/bin/bash
set -euo pipefail
pip install --quiet requests
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
python scripts/update_data.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Auto update [$(date +'%Y-%m-%d')]" && git push)
bash "$(dirname "$0")/commit_push.sh" "Auto update [$(date +'%Y-%m-%d')]"
+2 -4
View File
@@ -1,7 +1,5 @@
#!/bin/bash
set -euo pipefail
pip install --quiet requests
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
python scripts/top_offline.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Top offline [$(date +'%Y-%m-%d %H:%M')]" && git push)
bash "$(dirname "$0")/commit_push.sh" "Top offline [$(date +'%Y-%m-%d %H:%M')]"
+2 -4
View File
@@ -1,7 +1,5 @@
#!/bin/bash
set -euo pipefail
pip install --quiet requests
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
python scripts/top_online.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Top online [$(date +'%Y-%m-%d %H:%M')]" && git push)
bash "$(dirname "$0")/commit_push.sh" "Top online [$(date +'%Y-%m-%d %H:%M')]"
+9 -5
View File
@@ -1,8 +1,12 @@
#!/bin/bash
set -euo pipefail
pip install --quiet requests
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
python scripts/generate_tables.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Purge unhealthy [$(date +'%Y-%m-%d')]" && git push)
bash "$(dirname "$0")/commit_push.sh" "Purge unhealthy [$(date +'%Y-%m-%d')]"
+7 -12
View File
@@ -1,15 +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 requests
python scripts/refetch_all.py
# Regenerate tables with fresh data
python scripts/generate_tables.py
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add .
git diff --staged --quiet && echo "No changes" \
|| (git commit -m "Force re-fetch all games → v2.1 schema [$(date +'%Y-%m-%d')]" && git push)
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
python scripts/refetch_all.py --part "$part"
bash "$(dirname "$0")/commit_push.sh" "Force re-fetch, part ${part} [$(date +'%Y-%m-%d')]"
+12
View File
@@ -0,0 +1,12 @@
#!/bin/bash
set -euo pipefail
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
# PEAKS_ALL is the manual run's "backfill" box: "true" asks SteamCharts about
# every game (~4 h) instead of today's thirtieth. A scheduled run leaves it
# empty, and an unticked box sends "false" - neither may pass --all.
args=()
if [[ "${PEAKS_ALL:-}" == "true" ]]; then
args+=(--all)
fi
python scripts/refresh_peaks.py ${args[@]+"${args[@]}"}
bash "$(dirname "$0")/commit_push.sh" "Refresh all-time peaks [$(date +'%Y-%m-%d')]"
+15
View File
@@ -0,0 +1,15 @@
#!/bin/bash
set -euo pipefail
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
# REFRESH_ONLY from a manual run: "page" or "details" runs that group of the
# store refresh, "anticheat" only the anti-cheat sweep; empty = everything.
# Each part commits on its own, so a failure in the sweep never costs the
# store refresh its push (and set -e still stops at a crash in either).
if [[ "${REFRESH_ONLY:-}" != "anticheat" ]]; then
python scripts/refresh_store_data.py ${REFRESH_ONLY:+--only "$REFRESH_ONLY"}
bash "$(dirname "$0")/commit_push.sh" "Refresh store data [$(date +'%Y-%m-%d')]"
fi
if [[ -z "${REFRESH_ONLY:-}" || "${REFRESH_ONLY:-}" == "anticheat" ]]; then
python scripts/refresh_anticheat.py
bash "$(dirname "$0")/commit_push.sh" "Refresh anti-cheat [$(date +'%Y-%m-%d')]"
fi
+7 -4
View File
@@ -1,7 +1,10 @@
#!/bin/bash
set -euo pipefail
pip install --quiet requests
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
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git add . && git diff --staged --quiet && echo "No changes" || (git commit -m "Update reviews [$(date +'%Y-%m-%d')]" && git push)
bash "$(dirname "$0")/commit_push.sh" "Update reviews [$(date +'%Y-%m-%d')]"
+5
View File
@@ -0,0 +1,5 @@
#!/bin/bash
set -euo pipefail
# No pip install: snapshot.py and scripts/core/* are stdlib-only.
python scripts/snapshot.py
bash "$(dirname "$0")/commit_push.sh" "Snapshot [$(date +'%Y-%m-%d')]" data/snapshots/
+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.
Loaded 100 of 852 files, more files were not shown because too many files have changed in this diff. Show more