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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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.
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.
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.
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.
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.
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.
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>
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.
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.
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>
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.
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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>
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>
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>
/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>
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.
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.
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.
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.
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.
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.
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.
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.
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.
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>
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
- 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>
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.
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.
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.
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.
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.
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.
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>
- 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>
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>
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>
- 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>
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>
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>
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>
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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>
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>
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.
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>
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>
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>
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>
- 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>
@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>
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>
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>
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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>
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>
- 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>
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>
- 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>
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>
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>
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.
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.
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>
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>
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>
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>
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>
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.
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>
- 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>
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>
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>
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>
- 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>
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.
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.
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.
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.
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.
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.
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.
- 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>
.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>
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>
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>
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>
- 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>
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>
- 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>
- 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>
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>
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>
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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>
- 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>
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>
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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>
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>
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>
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>
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>
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>
- 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>
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>
/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>
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>
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>
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>
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.
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.
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.
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.
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>
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 & 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>
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.
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.
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.
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.
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.
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.
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.
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.
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>
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>
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>
- 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>
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>
# 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).)*',
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.
| 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:
- **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.
- **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
Yo, thanks for stopping by! This repo is a hobby project by a broke, unemployed Vietnamese dev (20-something, introvert max level, dropped out uni year 3, mooching off family, Steam library 400+ games 80% under $10 sale addiction). Powered ~70% by AI assistants — Grok for v1, Claude for v2+ — the only non-judgmental friends keeping this alive while I play Easy mode only :))
Want to help? Awesome — no strict rules, life's hard enough. Pick whichever path below is least-friction for you.
Want to help? Awesome — life's hard enough, so the rules are short.
## Project status: stable, maintenance only
Since 2026-11-11 the project is finished rather than abandoned. The pipeline
still refreshes the list every day and the site and apps stay up, but the code
is no longer growing:
- **No new features.** Feature requests are not taken, as issues, discussions
or pull requests. A pull request that adds one is closed, however good it is.
- **Code changes only for** security advisories (CVEs), runtime and dependency
updates (Node, Python, Rust, the npm / pip / cargo packages, the GitHub
Actions), and whatever those break. Dependabot opens most of them.
- **Issues and pull requests are for the data:** adding a game, correcting one,
removing one.
- Something **broken** (the site, an app, a wrong number) or an
**accessibility barrier** can still be reported. It gets a fix, not a
redesign.
- A **vulnerability** goes through [`SECURITY.md`](SECURITY.md), never a public
issue.
Forks are welcome to go further: the code is MIT and the dataset CC BY 4.0.
## Maintainer contact
@@ -27,48 +48,71 @@ reporting, see [`SECURITY.md`](SECURITY.md)), and <https://poli0981.dev/> or
## How to contribute
### 1. Open an issue (bugs, requests, removals)
### 1. Open an issue
Go to the [Issues tab](https://github.com/poli0981/free-steam-games-list/issues/new/choose) and pick a template:
Go to the [Issues tab](https://github.com/poli0981/free-steam-games-list/issues/new/choose) and pick a form:
- ➖**Delete game** (max 10 per issue)
- 🐛 **Bug report**
- 💡 **Feature request / improvement**
- 📢 **Feedback / rant**
- ❓ **Off-topic**
- ➕**Add game** — a free game that is still missing (max 10 per issue)
- ✏️ **Edit game** — a published game with something wrong: genre, type, anti-cheat, notes, safe
- ➖**Delete game** — paid now, not a game, malware, duplicate (max 10 per issue)
- 🐛 **Bug report** — something that is broken
- ♿ **Accessibility barrier** — something you can't use with a keyboard, a screen reader or zoom (see [`ACCESSIBILITY.md`](ACCESSIBILITY.md))
Fill the form (checkboxes, dropdowns, short descriptions). Every template is reviewed by hand when caffeine hits — none of them auto-run a workflow.
Blank issues are off. Every form is reviewed by hand when caffeine hits — none of them auto-run a workflow.
> Issues are for **reports**, not game submissions. To add a game, use the browser extension (section 2).
New free games are found on Steam automatically every day and reviewed before they are listed, so most turn up on their own. Use **Add game** for one that is still missing a few days after it went free.
### 2. Open a pull request (data)
### 2. Browser extension
Fork → branch → one of these → push → open the PR. The template has a short checklist.
The companion [Chrome extension](https://github.com/poli0981/steam-f2p-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.
**Add a game:** append store links to `scripts/temp_info.jsonl`.
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.
1. Fork → branch.
2. Edit code in `scripts/` / `web/src/` / docs, or append rows to `scripts/temp_info.jsonl`:
3. Push → open PR. Reviewer (= me) will look when caffeine hits.
**Correct a game:** add an override. It is a standing instruction in `data/overrides/<appid>.json` that every pipeline run keeps.
Manual fields preserved through the ingest pipeline: `type_game`, `genre`, `anti_cheat`, `anti_cheat_note`, `is_kernel_ac`, `safe`, `notes`.
```bash
python scripts/edit_game.py 730 --show
python scripts/edit_game.py 730 --set genre="FPS" --reason "Steam's genre is too coarse"
```
Only the human-judged fields can be overridden: `genre`, `type_game`, `safe`, `notes`, `anti_cheat`, `anti_cheat_note`, `is_kernel_ac`. Everything else (name, tags, languages, reviews, players…) is whatever Steam says and is refreshed from Steam.
**Remove a game:** add a blocklist line. The reason and the note are public.
```bash
python scripts/delete_game.py 730 --reason not_free --note "paid since 2026-11"
Leave out `--apply` in both commands, and **never edit `data/data_*.jsonl` or `data/index.json` by hand**: the pipeline rewrites them on its next run and an edit there is lost (and breaks the hashes the apps check). `Check Overrides` validates an override or blocklist change on the pull request.
### 3. Pull requests that touch code
Only two kinds are merged now:
- a **security fix** — report it privately first ([`SECURITY.md`](SECURITY.md));
- a **runtime or dependency update**, or the repair of what one broke.
`npm run typecheck && npm test && npm run build && node scripts/verify-dist.mjs --web` must pass in `web/`, and `python -m pytest scripts/tests` for the pipeline. Dependencies are pinned and hashed; the rules are in [`CLAUDE.md`](CLAUDE.md) ("CI installs only what is pinned").
The companion browser extension ([steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension)) is archived and no longer a way in.
---
## 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 web side (SvelteKit, the Worker, `admin/`) is TS-strict.
- **Tests:** for web changes, `npm run typecheck && npm test && npm run build` must pass (in `web/`). For pipeline changes, `python -m pytest scripts/tests`.
- **Notes / safe** are worth mentioning in an Add or Edit request ("safe to play", "Toxic max", "Grind phê Easy mode"); the maintainer records them as overrides.
- **Spam / off-topic / feature-request** issues get closed without comment. Don't be that person.
- **Questions and chit-chat** go to [Discussions](https://github.com/poli0981/free-steam-games-list/discussions), not issues.
## Code of conduct
@@ -78,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 :))
A **curated list** of free-to-play games on Steam — now ~3,600 of them — no quality guarantees, no endorsements, just pure listings by a broke, unemployed Vietnamese dev with too much free time and a Steam library full of sale games (80% under $10).
A **curated list** of free-to-play games on Steam — the badge above has today's count — no quality guarantees, no endorsements, just pure listings by a broke, unemployed Vietnamese dev with too much free time and a Steam library full of sale games (80% under $10).
**v4.0.0** is the version that got rebuilt from the ground up. It is still a list. It is also:
- 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+);
- a **review queue** at `/admin`, behind Cloudflare Access, where games found by the daily discovery sweep wait for a human to approve them;
- 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).
| 🏆 Top online (md) | [games/top-online.md](games/top-online.md) |
| 🎯 Top offline (md) | [games/top-offline.md](games/top-offline.md) |
| 📦 Raw data | [data/data_001.jsonl](data/data_001.jsonl) … `data_005.jsonl`(5 sharded JSONL files) |
| 📦 Raw data | [data/](data/) — JSONL shards of 800 games each (`data_001.jsonl`…), listed with a SHA-256 each in [`data/index.json`](data/index.json) |
| 🛠️ About | <https://free-steam-games.win/about> (in-app) |
| ♿ Accessibility | [`ACCESSIBILITY.md`](ACCESSIBILITY.md) — what works with a keyboard, screen reader and zoom, what doesn't yet, how to report a barrier |
### What's new in v4.0.0
### What's in v4
<details>
<summary><b>Web app at <code>free-steam-games.win/</code></b></summary>
A SvelteKit 2 / Svelte 5 app, prerendered and served by a Cloudflare Worker that also proxies the dataset (`/api/data/*`) and Steam artwork (`/img/*`), so your browser talks to this site only — apart from Cloudflare's analytics beacon and its Turnstile human check, both loaded only after you accept the terms. Features:
A SvelteKit 3 / Svelte 5 app, prerendered and served by a Cloudflare Worker that also proxies the dataset (`/api/data/*`) and Steam artwork (`/img/*`; on the website the art comes from the site's own media host, `media.free-steam-games.win`), so your browser talks to this site only — apart from Cloudflare's analytics beacon and its Turnstile human check, both loaded only after you accept the terms. Features:
- **Browse** — virtualised table (TanStack Virtual), filters for genre, type, platform, status, anti-cheat and safety, Fuse.js fuzzy search, sortable columns, 50/100/200/500/all pages. Filters live in the URL, so a filtered view can be shared.
- **Charts** — Apache ECharts: dashboard KPIs, genres, platforms, languages, tags, anti-cheat (chart and a searchable index), reviews, player tiers, release years and catalogue growth, DRM/DLC, delisted games, plus a stats page (Metacritic, retention, games that went quiet).
- **A page per game** — `/games/:appid` is prerendered for search engines and filled with live player counts and reviews in the browser.
- **Random games** — `/random` rolls one to five games when you cannot decide: online, offline or either, dead games only if you ask, never one marked unsafe. Roll again for a new set; opening a game and coming back keeps the picks.
- **Fresh data, verified** — `data/index.json` carries a SHA-256 per shard; the app only caches a generation it could verify, keeps the last good one offline, and re-checks when you come back to the tab.
- **Installable** — a web app you can install, with an offline mode and an update prompt.
- **i18n** vi / en — auto-detected, switchable from the welcome page or Settings.
- **⌘K command palette**, **first-run introduction**, and the legal documents rendered in the app.
Pushing to `main` deploys (Cloudflare Workers Builds). Pipeline commits to `data/**` do not need a rebuild: the data is proxied, not bundled. See [`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md).
Cloudflare Workers Builds deploys from `main`; which commits trigger a build is in [`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md). Pipeline commits to `data/**` do not need a rebuild: the data is proxied, not bundled.
</details>
@@ -60,7 +96,7 @@ Pushing to `main` deploys (Cloudflare Workers Builds). Pipeline commits to `data
A native shell around the same web app, distributed via [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases):
- Windows `.msi`, macOS `.dmg` (universal Apple Silicon + Intel), Linux `.AppImage` and `.deb`, and an Android `.apk`.
- Windows `.msi` and `-setup.exe`, macOS `.dmg` (universal Apple Silicon + Intel), Linux `.AppImage`, `.deb` and `.rpm`, and an Android `.apk`.
- Resizable window; `steam://` links open the Steam client.
- The desktop app checks for a signed update on start and installs it when you say so, keeping your settings.
- Same data path as the web app (`/api/data/*` on free-steam-games.win), same offline cache.
@@ -76,9 +112,9 @@ npm run tauri:build # release binary into web/src-tauri/target/release/bundle
</details>
<details>
<summary><b>The review queue at <code>/admin</code></b></summary>
<summary><b>The admin at <code>/admin</code></b></summary>
`Discover New Games` sweeps the Steam store daily and proposes candidates into a Cloudflare D1 queue. The maintainer reviews them in a small Svelte app embedded in the Worker (never shipped to visitors): approving commits the store link to `scripts/temp_info.jsonl`, and the pipeline does the rest. Decided and already-published rows are read-only. Corrections to published games are saved as override files that survive every pipeline run. See [`docs/ADMIN.md`](docs/ADMIN.md).
`Discover New Games` sweeps the Steam store daily for free games in every language, not only the ones that support English, and proposes candidates into a Cloudflare D1 queue. The maintainer reviews them in a small Svelte app embedded in the Worker (never shipped to visitors): approving commits the store link to `scripts/temp_info.jsonl`, and the pipeline does the rest, checking every game again (free, a game, reachable) before it is published. Approval can also run on its own, in batches with a daily cap, once the maintainer turns it on. Decided and already-published rows are read-only. Corrections to published games are saved as override files that survive every pipeline run, and a removed game goes into `data/blocklist.jsonl`, which keeps it out of the catalogue until it is restored. An overview, the pipeline's runs and a data-quality report complete it. See [`docs/ADMIN.md`](docs/ADMIN.md).
</details>
@@ -88,10 +124,9 @@ npm run tauri:build # release binary into web/src-tauri/target/release/bundle
The Python pipeline that powered v2 is untouched and runs daily as before:
- Schema v2.2 (23 + manual fields per record), CC BY 4.0 (see [LICENSE-DATA](LICENSE-DATA)), sharded data in `data/data_*.jsonl` (cap 800 records/shard) plus a `data/index.json` manifest with a SHA-256 per shard.
- Extension-compatible: the [Chrome extension](https://github.com/poli0981/steam-f2p-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.
- 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>
@@ -101,9 +136,11 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
| Auto Update JSON | Daily 00:00 UTC | Fills in incomplete records (API + HTML scrape) |
| Discover New Games | Daily 05:00 UTC | Propose new free games into the `/admin` review queue |
| Ingest New | On `scripts/temp_info.jsonl`push | Add approved and extension-submitted games |
| Discover New Games | Daily 05:00 UTC | Propose new free games, any language, to the `/admin` queue |
| Ingest New | On `scripts/temp_info.jsonl`or `data/blocklist.jsonl` push, and every 3 h | Apply removals, then add approved games |
| Top Online | Sun/Wed/Fri 03:00 UTC | Live player leaderboard |
| Top Offline | 1st + 15th of month 05:00 UTC | Leaderboard for single-player F2P concurrents |
| Update Reviews | Every 2 days 06:00 UTC | Reviews-only refresh |
| 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 |
| 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 |
| 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 ALL games |
| Force Re-fetch | Manual only | Re-fetch games from scratch, one part (`1/8` … `8/8`) a run |
| Web CI / Python Tests | On `web/**` / `scripts/**` change | Type check, tests, build and output checks |
| Release Desktop / Android | On `desktop-v*` / `android-v*` tag | Build the apps into a draft release |
| Announce Discussion | On release `published` | Auto-create a GitHub Discussion in `Announcements` |
The site itself is deployed by Cloudflare Workers Builds on every push to `main`, not by a workflow.
Also in `.github/workflows/`:
- **CodeQL**, **SonarCloud** and **Qodana** (Python, JS/TS, Rust): code scanning on pushes and pull requests.
- **Check Overrides**: pull requests that touch the override or blocklist files.
- **Backfill Discovery**: temporary; a weekly re-sweep of older release windows into the same `/admin` queue.
- **Announce Release to Discord**: posts each published release.
- Three **Notify** workflows: CI failures, the Pages deploy, the release pipeline.
- **Deploy Web (GitHub Pages)**: it only serves a redirect to the new site now.
The site itself is deployed by Cloudflare Workers Builds, not by a workflow.
### Contribute
**The browser extension.** The companion [Chrome extension](https://github.com/poli0981/steam-f2p-extension) detects
free-to-play games on Steam store pages and pushes pre-fetched metadata straight
to `scripts/temp_info.jsonl`; `Ingest New Game Links` merges and dedupes on push.
This is the only submission route.
The repository is in [maintenance mode](#project-status): contributions are
about the **data**.
Most new games arrive on their own: `Discover New Games` sweeps the Steam store
daily into a review queue, and the maintainer approves them at `/admin`.
Discovery only proposes — publication is always a human decision.
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.
[Delete game](.github/ISSUE_TEMPLATE/delete_game.yml) and
[Feedback](.github/ISSUE_TEMPLATE/feedback.yml). All reviewed by hand.
**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>` |
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.
@@ -224,6 +282,7 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
- v2.1 was spaghetti with proper seasoning. It got a scraper.
- v3.0 was spaghetti with a website on top, a desktop app, and bilingual menus.
- **v4.0 is the same spaghetti, rebuilt, with a review queue so it stops needing to be cooked by hand.** Still a hobby.
- v4.7 is where the cooking stops: the dish is served, and from here it is only kept warm.
> [!WARNING]
> **Disclaimer.** Quality / fun / safety: who knows. The maintainer only vouches for games personally played (`safe` column: `y` = yes, `?` = dunno, `n` = nope). Problems with a game are between you, Valve, and the developer of that game — not the maintainer. See [`docs/DISCLAIMER.md`](docs/DISCLAIMER.md) for the specific accuracy caveats.
@@ -231,10 +290,10 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
- [Security setup](docs/SECURITY_SETUP.md) — the operational side: headers, WAF, rate limits, Access, each with a check command.
- [ACCESSIBILITY](ACCESSIBILITY.md) — what works with a keyboard, screen reader and zoom, what doesn't yet, and how to report a barrier.
- [Android support](docs/android-support.md) ([VI](docs/i18n/vi/android-support.md)) — why Android 11+, and what the APK is tested on.
- [`web/README.md`](web/README.md) — web stack, data paths, CSP, PWA, i18n, build and checks.
Code is [MIT](LICENSE); the dataset is [CC BY 4.0](LICENSE-DATA) with carve-outs for fields the project does not own (`description`, `header_image`). Keep the right licence with you if you fork. Star if you find a hidden gem ✨
# 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 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 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.
- 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).
- `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).
# 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.
- **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.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.
- `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()`.
- 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 }`:
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).
# 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`.
- 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).
- 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).
- 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).
# 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.
- 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.).
- 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.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.
# 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.
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.
- `GamesTable.tsx` keeps the virtualizer (`useVirtualizer` ownership at container level so row-height stays single-source), filters, fuzzy search, sort, and paging.
- `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.
- `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.
# 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`.
# 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.
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`).
- **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`.
# 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.
- 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.
# 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`.
# 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`).
- 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).
# 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).
An accessibility release. The repository gains an accessibility statement
that says honestly what works with a keyboard, a screen reader and zoom, and
what does not yet. The worst barriers it found are fixed:
- the games table is a real table to a screen reader;
- the first-run screens hold the keyboard focus;
- kernel-level anti-cheat is no longer told apart by colour alone;
- both themes meet the contrast WCAG asks for;
- the desktop app zooms.
Like a curb cut, most of it helps everyone. The community docs were also
brought back in line with the repository. No legal document you accept
changed, so nobody is asked to accept the terms again.
Desktop and Android go from `2.5.0` to `2.5.1`, and the repo's public version
from `4.7.0` to `4.7.1`. The desktop app offers 2.5.1 through its updater once
the release is published. On Android, install the new APK over the old one.
## ✨ Added
- **An accessibility statement.**`ACCESSIBILITY.md` says what works today
with a keyboard, a screen reader and zoom, and what does not work yet: the
games table, most charts, the first-run screens, zoom in the apps. It also
lists which browsers and apps are checked by hand, and how a report is
handled. GitHub shows it as the repository's Accessibility tab. Barriers get
their own issue form and an `accessibility` label, and the About page links
the statement and the form.
- A pull request template covering what and why, the checks to run, and a
short accessibility list for interface changes.
## 🐛 Fixed
- The About page's stack list said SvelteKit 2 and counted 3,600 rows. Its
footnote said everything the page loads comes from this site, which is not
true of Cloudflare's beacon and human check. It now says what is true: the
game data and art come from this site. The Vietnamese AI note gains the
sentence it was missing.
- Source archives (`git archive`, GitHub's "Source code" downloads) left out
three legal documents that the web build reads, so building from one
stopped. They are included now.
- **Accessibility**, on the website and in the apps from 2.5.1:
- **The games table** is now a table to a screen reader. It exposes its
roles, the row and column counts, and a position for every row, even
though only the rows on screen exist. The image, data-issue and Steam
columns have names.
- **Table rows** are no longer a link wrapped around another link, and each
row is one <kbd>Tab</kbd> stop instead of two. Clicking anywhere on a row
still opens the game.
- **The phone cards** are a list that tells a screen reader its length and
each card's position.
- **The terms screen and the human check** are dialogs that take focus, and
the page behind them is out of reach until you are through. Before, Tab
walked through the hidden page first, and Ctrl/⌘+K could open the
command palette underneath them, out of sight but holding focus.
- **Kernel-level anti-cheat** shows a shield icon and the words, not only a
red badge.
- **Contrast:**
- Light-theme links, primary buttons, warnings and badges reach 4.5:1.
The light theme's amber is a shade darker as a result.
- Red badges in the dark theme reach 4.5:1 too.
- Text boxes and drop-downs have a visible 3:1 edge in both themes.
- **Zoom:**
- The games list keeps a minimum height when zoomed in, instead of
shrinking to nothing at 300-400%.
- The desktop app zooms with Ctrl/⌘ and + / −.
- **Smaller fixes:**
- "Back to top" is out of the Tab order while it is hidden, and jumps
instead of gliding when *reduce motion* is on.
- The command palette's search box shows a focus ring.
- Screen readers read out the 💀 and the table's warning icon as words.
- `ACCESSIBILITY.md` moves all of this from "Known limitations" to "What
works today".
## 🧰 Tooling & misc
- `web/src/lib/a11y.test.ts` holds those fixes in the code. It also computes
the theme's contrast with the WCAG formula, so a colour edit that drops
below 4.5:1 for text, or below 3:1 for a control's edge, fails the tests.
## 📚 Docs
- The community docs match the repository again:
- **README:** live game-count and version badges, SvelteKit 3, every desktop
package, the shard layout, the workflows its table left out, and which
commits deploy.
- **SECURITY.md:** the real stack, pushes with the built-in token, and the
media host and the ingest and update endpoints in scope.
- **AUTHORS.md, `username.txt`, CONTRIBUTING.md and the code of conduct.**
- **The issue forms:** the hash links, GitHub Pages permalinks and the
editing and GPG options are gone. The version is under the title, not
behind a hover.
- **`web/README.md`, `docs/dev_env.md` (EN + VI), the acknowledgements and
the contact page.** Neither of the last two is a document you accept, so
nobody is asked to accept the terms again.
- `CLAUDE.md`: `ACCESSIBILITY.md` is a claim about the code, kept true in the
same pull request, and the rules behind the accessibility fixes.
Loaded 100 of 473 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.