Merge pull request #261 from poli0981/docs/changelog-split

docs: split CHANGELOG.md into one file per release
This commit is contained in:
poli0981 authored and GitHub committed 2026-11-17 09:05:17 +07:00
commit a551e57ca1
49 files changed
+2253 -2096

No files matched your search

+1
View File
@@ -17,6 +17,7 @@ CONTRIBUTING.md export-ignore
SECURITY.md export-ignore
ACCESSIBILITY.md export-ignore
CHANGELOG.md export-ignore
changelog/ export-ignore
README.md export-ignore
# The legal documents stay IN the archive: the web build reads all of them
# (web/build/legal-versions.ts) and stops when one is missing.
+60 -2094
View File
File diff suppressed because it is too large. Load diff
+8
View File
@@ -30,6 +30,14 @@ keep running; the code no longer grows. What that means for any change:
file name, so renaming a form is a web change.
- The policy is stated in `README.md` ("Project status"), `CONTRIBUTING.md`,
`SECURITY.md` and the pull-request template: change them together.
- **Release notes are one file per release**:
`changelog/v<major>/<major>.<minor>.x/<version>.md`, and `changelog/beta/`
for a pre-release (none so far). `CHANGELOG.md` is the index, and keeps
`## [Unreleased]`, where every change writes its entry. A release moves that
section into its new file (headings one level up, relative links prefixed
`../../../`), adds its row to its major's table and empties [Unreleased];
what the file says below its title and back link is the GitHub release's
notes. A released file is not reworded afterwards.
- Every rule below still holds. Maintenance mode is when they matter most:
the next change will be made by someone who has not touched the code for
months.
+1 -1
View File
@@ -290,7 +290,7 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
### Docs
- [AUTHORS](AUTHORS.md) — maintainer + canonical handle map + AI-assistant disclosure.
- [CHANGELOG](CHANGELOG.md) — what changed in each version.
- [CHANGELOG](CHANGELOG.md) — what changed in each version: the index, with one file per release in [`changelog/`](changelog/).
- [CONTRIBUTING](CONTRIBUTING.md) — maintenance mode, what is accepted, and how to add, correct or remove a game.
- [PC spec](docs/pc_spec.md) ([VI](docs/i18n/vi/pc_spec.md)) — maintainer's dev hardware + test devices.
- [Dev environment](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)) — IDE, toolchains (Python 3.15 / Node 26 / TypeScript 7 / Rust stable / Tauri 2), workflow.
+14
View File
@@ -0,0 +1,14 @@
# Changelog files
One file per release, newest version first in the index:
[`CHANGELOG.md`](../CHANGELOG.md) at the root lists them all, with what is not
released yet.
- `v<major>/<major>.<minor>.x/<version>.md` - a release, e.g.
[`v4/4.7.x/4.7.1.md`](v4/4.7.x/4.7.1.md). Its first line is the release
heading; the rest is the release notes, which is also what the GitHub
release of that tag says.
- [`beta/`](beta/) - pre-releases (none so far).
A file is written once, when its version is released, and is not reworded
afterwards: it records what was true then, links and file names included.
+9
View File
@@ -0,0 +1,9 @@
# Pre-releases
Notes for a beta, alpha or release candidate go here, one file per
pre-release, named for its version: `5.0.0-beta.1.md`. When the line goes
stable its release gets a file of its own under `v<major>/`; the beta files
stay, as the record of what changed during the run-up.
None has been published: every release so far, v1.0.0 to the latest in
[`CHANGELOG.md`](../../CHANGELOG.md), was a stable one.
+20
View File
@@ -0,0 +1,20 @@
# v1.0.0 - 2025-12-22 (Initial stable release)
[All versions](../../../CHANGELOG.md)
From the GitHub release of v1.0.0 ("v1.0.0 - Released"); the changelog
itself starts with v1.1.0.
First stable release – the repo is alive!
- Auto daily fresh stats + immediate update on data.json push
- Tables with thumbnails, reviews sort best first, safe/noob notes
- Genre files + top online multiplayer
- Chained workflows, robust fetch/generate
- Bug/feature templates
From a broke unemployed Vietnamese dev (Easy mode only) + Grok AI buddy 70% power.
Thanks for starring/watching – wallet safe, play free games :))
Next? More games, more noob notes, maybe dynamic badges if not lazy.
+10
View File
@@ -0,0 +1,10 @@
# v1.1.0 - 2025-12-30 (Scale Noob Edition)
[All versions](../../../CHANGELOG.md)
- Split all-games.md into parts. Smart fetch skip. Wiki. Issue templates.
- Batch + delay optimize for 500+ games. Various Action fixes.
Previous: [v1.0.0] – Initial stable.
Made with boredom, instant noodles, sale addiction, and AI power ✨
+5
View File
@@ -0,0 +1,5 @@
# v1.1.1 - 2026-01-07
[All versions](../../../CHANGELOG.md)
- 50+ games, delete/dedup scripts, CSV export, auto CSV Actions. (by [@poli0981](https://github.com/poli0981))
+5
View File
@@ -0,0 +1,5 @@
# v1.1.2 - 2026-01-11
[All versions](../../../CHANGELOG.md)
- 40+ games added.
+8
View File
@@ -0,0 +1,8 @@
# v1.1.3 - 2026-01-15
[All versions](../../../CHANGELOG.md)
From the message of the tag `v1.1.3`; it has no GitHub release and
had no section in the changelog.
- 30+ games added.
+17
View File
@@ -0,0 +1,17 @@
# v2.0.0 - 2026-03-26 (The "Finally Got Serious" Edition)
[All versions](../../../CHANGELOG.md)
## 💥 Breaking Changes
- Data format migrated from `data.json` to `data.jsonl` (JSON Lines).
- All Python scripts rewritten from scratch under `scripts/core/` modular architecture.
- Bash scripts rewritten with `set -euo pipefail`.
## 🏗️ Architecture (Complete Rewrite)
- Modular core: `constants.py`, `steam_client.py`, `data_store.py`, `fetcher.py`, `health_checker.py`.
- Rate-limited HTTP client with backoff, retry, 429 handling, session pooling.
- Health detection (5 statuses), purge, dead link check, pre-flight ingest validation.
- New ingest flow: `temp_info.jsonl` → validate → dedup → health check → fetch → `data.jsonl`.
- 9 CI/CD workflows. Metacritic, DRM, Peak Today, Status columns. Top Online leaderboard with trends.
+85
View File
@@ -0,0 +1,85 @@
# v2.1.0 - 2026-03-28 (The "Extension-Ready + Performance" Edition)
[All versions](../../../CHANGELOG.md)
## 💥 Breaking Changes
- `desc` field **removed** from schema. Use `description` only. Migration script handles upgrade automatically.
- `free_type` field removed (unreliable from API, extension handles classification client-side).
- `jsonlines` pip dependency dropped – all I/O now uses stdlib `json` (faster, zero deps).
- `fetcher.py` function renamed: `_process_batch()` → `process_batch()` (public API).
## 🏗️ Schema v2.1 (Extension-Compatible)
- **7 new fields** added to every game record, matching Chrome extension output:
- `publisher` (list) – e.g. `["Square Enix", "Feral Interactive (Mac)"]`
- `platforms` (list) – e.g. `["Windows", "macOS", "Linux"]`
- `languages` (list) – e.g. `["English", "French", "Japanese"]`
- `language_details` (list[dict]) – per-language `{name, interface, audio, subtitles}` booleans
- `tags` (list) – all user-defined Steam tags including hidden overflow
- `anti_cheat_note` (str) – raw anti-cheat name from store page
- `is_kernel_ac` (bool|null) – `true` = kernel-level, `false` = non-kernel, `null` = unknown
- `developer` normalized: string → list everywhere (API, extension, migration).
- `desc` merged into `description`, then dropped. One field, no duplication.
## 🔌 Extension Data Integration
- New `merge_extension_data()` in `data_store.py` – smart merge with 3-tier priority:
- **MANUAL_FIELDS** (notes, safe, type_game, genre, anti_cheat): only fill if empty (preserves user edits).
- **ARRAY_FIELDS** (developer, publisher, platforms, languages, tags): replace wholesale (extension data is richer).
- **Other fields**: overwrite if extension provides non-empty value.
- `ingest_new.py` now accepts full extension output (20+ fields per entry) – merges before fetch, re-applies manual
overrides after fetch.
- Ingest summary shows field counts: `dev=DONTNOD plat=[Windows, macOS, Linux] langs=6 tags=20`.
## 🔍 HTML Scraper (New Module)
- New `scraper.py` – extracts data unavailable from Steam API:
- **Language table**: parses `<table class="game_language_options">` → accurate Interface/Audio/Subtitles per
language (API only gives a broken HTML string with no subtitle info).
- **DLC pricing**: parses `#gameAreaDLCSection` → checks `data-price-final` per DLC row. Only marks
`has_paid_dlc=true` if at least one DLC has actual non-zero price (API just lists DLC IDs with no prices).
- **Tags**: parses `.app_tag` elements including `display:none` overflow tags (API `appdetails` doesn't return user
tags at all).
- All 3 extracted from **single GET request** to store page – one HTML fetch per game, not three.
- 8 regex patterns pre-compiled at module level.
## ⚡ Performance Optimizations
- **Eliminated double-fetch in ingest**: `health_checker` now caches API response in `HealthResult.data`.
`ingest_new.py` passes `prefetched_details=health.data` to `fetch_full()` → skips redundant `fetch_app_details()`
call. Saves 1 API request per game (300 games = ~450s saved).
- **Dropped jsonlines dependency**: `load_jsonl()` uses `json.loads()` line-by-line, `save_jsonl()` uses
`json.dumps()` + `f.write()` directly. ~20-30% faster I/O for large files, zero pip deps for core.
- **Pre-compiled regex**: `scraper.py` compiles all 8 patterns at import time, not per-call. 300 games = 8 compiles
instead of 2400.
- **Faster `is_empty()`**: uses `frozenset` lookup for empty string variants, early returns for `None`/`list`.
- **`SteamClient.__slots__`**: reduced memory per instance, faster attribute access.
- **`extract_appid()` regex simplified**: `/app/(\d+)` instead of full domain match – shorter, same correctness.
- **`make_skeleton()` template**: shallow-copies from frozen template dict instead of building from scratch.
- **`generate_tables.py`**: `lines.extend(generator)` instead of `append()` loop.
## 🔄 New Scripts & Workflows
- `refetch_all.py` + `refetch-all.yml` – **manual-only** force re-fetch of ALL games into v2.1 schema. Creates backup →
migrates → clears fetchable fields → re-fetches from Steam API + HTML scrape. Preserves manual fields (notes, safe,
type_game). Requires typing `"yes"` to confirm. Timeout: 120 minutes.
- `migrate_schema.py` + `migrate-schema.yml` – upgrades existing `data.jsonl` records: adds missing fields, normalizes
types, drops deprecated fields. Idempotent.
## 🐛 Bug Fixes
- **`languages` corrupted**: API HTML string `"Brazil<br>languages with full audio"` was parsed as
`"Brazillanguages..."`. Fixed by switching to HTML table scraping.
- **`subtitles` always `false`**: API has no subtitle breakdown. Fixed by parsing store page language table (
Interface/Audio/Subtitles columns).
- **`has_paid_dlc` false positives**: Games with free-only DLC were marked `true`. Fixed by scraping actual
`data-price-final` attributes.
- **`description` duplicated**: Both `desc` and `description` stored same text. Unified to `description` only.
## 🧹 Improved
- Tables: Publisher column, Platforms column, Language count, kernel anti-cheat badge (🔴/🟢).
- `health_checker.py`: `@dataclass(slots=True)` for leaner objects.
- `top_online.py`: tier thresholds as tuple list (cleaner).
- All scripts: consistent `sys.path.insert(0, ...)` for imports.
+50
View File
@@ -0,0 +1,50 @@
# v3.0.0 – 2026-05-07 (The "It Has a Website Now" Edition)
[All versions](../../../CHANGELOG.md)
The repo is no longer just a list. It is a **list + a React/Vite web app + a Tauri desktop app**, all reading the same Python-pipeline-maintained data.
## 🌐 Web app — `web/` + GitHub Pages
Built across phases 1 → 7. Live at <https://poli0981.github.io/free-steam-games-list/>.
- **Phase 1** — read-only browse: virtualised 1.2k-row TanStack table, faceted filters, Fuse.js fuzzy search, 4 ECharts MVP charts (KPI, top-online, genre treemap, platform donut), GitHub Pages deploy via `actions/deploy-pages`.
- **Phase 2** — PAT-based GitHub auth, single-record edit drawer for the 8 manual fields, diff viewer, single + bulk Steam-link queue into `scripts/temp_info.jsonl`, conflict-retry, sonner toasts.
- **Phase 3** — client-side OpenPGP signing via Git Data API: switched all writes from Contents API to `commitFile(getHead → createBlob → createTree → buildCommitContent → openpgp.sign → createCommit → updateRef)`. Settings panel with passphrase unlock + lock indicator. Earlier claim that PATs auto-sign was wrong — Contents API commits land Unverified.
- **Phase 4** — fixed GPG salt-notation incompatibility (`config.nonDeterministicSignaturesViaNotation: false`) so OpenPGP.js v6 signatures parse on GitHub. Bulk edit + bulk delete in one signed multi-shard commit. 8 remaining charts (tags wordcloud, AC stacked, languages heatmap, release-year histogram, catalog-growth cumulative line, reviews histogram, online player tiers pie, DRM/DLC bars). Health page with workflow_dispatch buttons. ⌘K command palette (cmdk).
- **Phase 4.1** — GPG signature payload fix: dropped trailing `\n` after the commit message so our signed bytes match `verification.payload` byte-for-byte. Verified via `gh api .../commits/{sha}.commit.verification.reason → valid`.
- **Phase 5** — PWA (installable, offline shell + last-known data via Workbox), GPG identity override (multi-UID picker), GPG idle auto-lock 5/15/30/60 min, Activity feed page (`/activity`) with Verified-status badges + Me/Bots/All filters.
- **Phase 6** — curated enums (`ANTI_CHEAT_ENUM`, `GENRE_ENUM`) + dropdowns, JSON-editor toggle in the edit drawer (full-record replace), manual-field overrides on Add (single + bulk JSON mode propagates `genre/type_game/anti_cheat/notes/safe` straight into `temp_info.jsonl`), GamesTable pagination 50/100/200/500/all + hidden scrollbar + per-row validation badge, per-game permalinks `/games/:appid` with friendly 404 drawer, verify-after-commit polling (toast updates with `verification.reason` once GitHub confirms), CSV/JSON export of the filtered subset, About page (repo + dev info from `username.txt` + 3rd-party stack + issue templates), topbar GPG quick-unlock popover, owner-gate (`useIsOwner` + `OWNER_LOGIN`) hides edit/add/delete UI from non-owners.
- **Phase 6.1** — Edit Always Failing fix: Contents API caps `content` at 1 MB; `data/data_001.jsonl` is 1.49 MB so the read came back empty and every edit threw "Record not found". New `getRepoFileText()` helper falls back to the `/git/blobs/{sha}` endpoint for oversize files.
- **Phase 6.2** — stale-after-edit fix: bumped `data/index.json.last_updated` in every shard-modifying commit AND switched the SW cache to `NetworkFirst` (raw.github CDN is Fastly-cached for 5 min). Plus optimistic-update helpers (`optimisticEdit/Replace/BulkEdit/BulkDelete`) write straight to TanStack + IndexedDB so the editor sees their own change instantly without waiting for the CDN.
- **Phase 7** — date-column sort fix (`parseReleaseDate`), hamburger mobile nav (Sheet drawer, auto-close on route change), About expansion (Heads-up caveats + AI disclosure + legal links + per-third-party SPDX licence badges), legal docs rewritten (DISCLAIMER + EULA + ToS + PRIVACY) with the four caveats from `notes.txt` (genre best-effort, English-only, test-data leakage, unsigned-commit dev artefacts), refreshed `bug_report.yml`, workflow Node 20 → 24 + actions versions bumped.
## 🌍 i18n — vi / en (Phase 8, this release)
- `react-i18next` + `i18next-browser-languagedetector`. Resource files `src/i18n/locales/{en,vi}.json`.
- Auto-detect from `navigator.language` on first load; persistent override via Settings → Language.
- Sidebar nav, Topbar, Settings, Dashboard, Top Online, common buttons, common toast strings translated. Long-form legal copy stays English by design (legal review hard to mirror exactly across two languages).
## 🖥️ Desktop app — Tauri 2 (Phase 8, this release)
- `web/src-tauri/` Rust scaffold targeting Tauri 2. Single `main` window, fixed 1400 × 900, no resize, no maximise, dark theme, centred at startup.
- `tauri-plugin-shell` for opening external links to Steam / GitHub from the embedded UI.
- New `release-desktop.yml` workflow: matrix `ubuntu-latest` / `windows-latest` / `macos-latest`, Apple Silicon + Intel universal binaries, `tauri-apps/tauri-action`. Triggered by `desktop-v*` tags or manual workflow run. Each run creates a draft GitHub Release with `.msi` / `.dmg` / `.AppImage` / `.deb` assets.
- `npm run tauri:dev` and `npm run tauri:build` from `web/` for local builds.
## 📦 Versioning
- Repo version badge **2.1.0 → 3.0.0**.
- `web/package.json` **0.1.0 → 1.0.0** (web app considered first-stable).
- `web/src-tauri/Cargo.toml` and `tauri.conf.json` ship at `1.0.0`.
## 📝 Docs (this release)
- `README.md` — rewrite: web app + desktop sections, updated Quick Links table, new architecture diagram, refreshed contribute paths, refreshed docs index.
- `CHANGELOG.md` — this entry consolidating phases 1 → 8.
- `docs/ACKNOWLEDGEMENTs.md` — refreshed with phase-by-phase AI assistance breakdown (Grok v1; Claude for v2 + the entire web/desktop layer + this changelog).
- `web/README.md` — phase 8 status appended.
## 🛠️ Pipelines unchanged
- All 9 v2.x Python pipeline workflows (update-json, generate-tables, top-online, update-reviews, dead-link-check, purge-unhealthy, ingest-new, ingest-from-issue, refetch-all) keep their schedules and behaviour. Two new workflows added: `deploy-pages.yml` (Phase 1) and `release-desktop.yml` (Phase 8).
+48
View File
@@ -0,0 +1,48 @@
# v3.0.1 – 2026-05-07 (The "Desktop Actually Ships This Time" Edition)
[All versions](../../../CHANGELOG.md)
Same-day post-v3.0.0 maintenance covering Phase 9 (auto-update foundations + CVE bumps + Device Flow scaffold), Phase 10 (Tauri build break + i18n full coverage + deps audit), and Phase 10.1 (minisign keypair rotation). The desktop release pipeline is now end-to-end green — `desktop-v1.0.0` finally produces signed `.msi` / `.exe` / `.dmg` / `.AppImage` / `.deb` / `.rpm` artefacts with a valid `latest.json` for auto-update.
## 🖥️ Phase 9 — auto-update foundations (#56)
- `tauri-plugin-updater` wired into `web/src-tauri/`. Endpoint pinned to the Releases page so installed clients fetch `latest.json` on launch.
- Updater pubkey embedded in `tauri.conf.json` (gated behind a no-op for mobile builds via `#[cfg(not(any(target_os="android", target_os="ios")))]`).
- GitHub Device Flow scaffold added to Settings: signed-in users no longer have to paste a long-lived PAT — they kick off `https://github.com/login/device`, type the user_code, and the app polls until token issuance. Falls back to PAT for the offline path.
- Dependency CVE bumps (vite 5 → 7, vite-plugin-pwa 0.20 → 1.x). Path-traversal fix in source-map handling. No source changes required for the bumps.
- More i18n: a chunk of edit-drawer / activity / dashboard chrome got proper translation keys.
## 🛠️ Phase 10 — Tauri build break + full i18n + deps audit (#57)
- **Tauri lib-name regression fixed.** Phase 9's auto-updater work introduced a `f2p_tracker_lib::run()` call in `main.rs` without declaring `[lib]` in `Cargo.toml`. Cargo's implicit lib name is `f2p_tracker` (hyphens → underscores from the package name) so the call failed to resolve and `cargo build` blew up. Added the explicit Tauri-2-template-style block:
```toml
[lib]
name = "f2p_tracker_lib"
crate-type = ["staticlib", "cdylib", "rlib"]
```
The triple crate-type keeps the door open for future `tauri ios init` / `tauri android init` work that `lib.rs`'s `#[cfg_attr(mobile, tauri::mobile_entry_point)]` already implies.
- **i18n now reaches every chrome surface** (~150 new keys across new namespaces `charts`, `activity`, `add`, `system`, `cmdk`, `about`, `bulk`, `detail`, `diff`, `dialogs`, `health`). All 9 chart pages, Activity, Add, Health, Top Online, About headings, drawers (Edit / BulkEdit / Diff / GameDetail), `PwaIndicator`, `QueryState`, `GpgQuickUnlock`, `Topbar` tooltips/aria-labels, `Settings` rate-limit panel, `BulkActionBar` confirm dialog, `GamesTable` tooltips, and `CommandPalette` resolve through `useTranslation`. Long-form About prose stays English per the `settings.languageHint` policy. Enum values (anti-cheat / genre / type_game / safe) stay dataset-stable.
- **Third-party deps audit.** Walked `web/package.json` against `About → Stack & third-party` and `docs/ACKNOWLEDGEMENTs.md`. Added missing entries: `react-router-dom`, the i18next stack (`i18next` + `react-i18next` + `i18next-browser-languagedetector`), Tauri 2 + plugins (shell / updater / process), `echarts-for-react`, the styling utilities (`class-variance-authority` / `clsx` / `tailwind-merge` / `tailwindcss-animate`), and PostCSS + autoprefixer. Vite version corrected 5 → 7 (was already bumped by Phase 9; About just hadn't caught up).
- `ACKNOWLEDGEMENTs.md` restructured into grouped sections (runtime/build, styling, UI primitives, routing & i18n, data & state, charts, crypto & PWA, desktop) with deep links + SPDX licences.
- `web/src-tauri/Cargo.lock` now committed for reproducible desktop builds.
## 🔑 Phase 10.1 — minisign keypair rotation (#58)
- `desktop-v1.0.0` was failing at the final sign-updater-bundle step:
```
failed to decode secret key: incorrect updater private key password:
Missing comment in secret key
```
minisign formats the error so the inner "Missing comment" is the symptom of a wrong password — when the password is wrong, decryption returns garbage and the expected `untrusted comment: minisign encrypted secret key` header bytes don't appear. The original keypair's password was lost, so the GH secret could no longer decrypt the key.
- Re-keyed via `npx tauri signer generate --ci -p ""` with no password. Stored at `~/.tauri/f2p-tracker{,.pub}` on the maintainer's box; `web/src-tauri/.gitignore` extended (`*.key`, `f2p-tracker{,.pub}`) as a guardrail in case keys ever land in `src-tauri/` during dev.
- New pubkey baked into `tauri.conf.json` `plugins.updater.pubkey`. GH secrets `TAURI_SIGNING_PRIVATE_KEY` and `TAURI_SIGNING_PRIVATE_KEY_PASSWORD` rotated via `gh secret set` (password = empty string).
- **Trade-off**: any user already on a build signed with the old key would have their auto-update break. Nobody hit that path because Phase 9 / Phase 10 release runs both failed before publishing artefacts. Phase 10.1's rebuild is the first actually-shipped `desktop-v1.0.0`.
## 🏷️ Tag handling
- `desktop-v1.0.0` was force-pushed twice in this cycle as the workflow input commit advanced (Phase 9 → Phase 10 → Phase 10.1). The triggering tag is GPG-signed each time. Once the auto-update story is real users-on-it, future fixes should bump `desktop-v1.0.x` instead of force-pushing.
## 📝 Docs (this release)
- `CHANGELOG.md` — this entry.
- `web/src-tauri/Cargo.toml` + `tauri.conf.json` + `.gitignore` — Phase 10 / 10.1 changes documented in their own commit messages and PR bodies (#57, #58).
+60
View File
@@ -0,0 +1,60 @@
# v3.1.0 – 2026-05-09 (The "Less CI Noise, Lighter Images, Dead-Game Detection" Edition)
[All versions](../../../CHANGELOG.md)
Four PRs landed in this release plus a refresh of the docs and the contributor surface around the new Telegram bot. Web app + desktop app bumped from `1.0.0` → `1.1.0`. Repo public-facing version `3.0.1` → `3.1.0`. Tag `v3.1.0` is GPG-signed; companion desktop tag is `desktop-v1.1.0`.
## 🛠️ CI hygiene — notify wrappers (#60)
- The 3 notify wrappers (`notify-ci-failure`, `notify-deploy`, `notify-release-pipeline`) used to trigger on `workflow_run: workflows: ["*"]` and were filtered out by their reusable callee's `if:` — 95–100 % of runs showed as "skipped". Replaced the catch-all with explicit lists of source workflow `name:` strings per wrapper, plus job-level `if:` to short-circuit non-matching conclusions. Drops skip rate to <10 %.
- Trade-off documented in each file: renaming a source workflow's `name:` field silently breaks notifications; comment warns about the coupling.
## 🖼️ Image optimisation — capsule swap + WebP via wsrv.nl (#61)
- `scripts/generate_tables.py:68` — markdown thumbnails now use `capsule_184x69.jpg` instead of `header.jpg` (~80 % bandwidth reduction at the same 120 px render width).
- Web app `GamesTable` + `CommandPalette` — capsule swap with explicit `width`/`height` to eliminate CLS, plus `onError` fallback to `header.jpg` for the ~5 % of games without a capsule variant.
- `GameDetailDrawer` — `<picture>` element with WebP source via `images.weserv.nl` proxy + JPEG fallback. Lazy-loaded, explicit dimensions.
- `vite.config.ts` — new `CacheFirst` runtime cache for `images.weserv.nl` (`statuses: [200]` only — opaque 0-status would cache proxy errors).
- New helper `web/src/lib/image.ts` — `headerToCapsule()` + `webpProxyUrl()`.
## 💀 Dead-game detection — `mark-dead-games.yml` (#62)
- New cron `Mon + Thu 04:30 UTC` flags **online games released >1 year ago** whose `current_players == 0` for **≥14 days** (configurable via `DEAD_GAME_DAYS` env or `--days` CLI). On trigger: `is_dead = true` + `"💀 Dead game"` appended to `notes` (idempotent).
- **State model**: ISO timestamp `zero_player_since` (robust against schedule drift), not a streak counter.
- **Mark mechanism**: additive `is_dead: bool` + note. `status` stays `"active"` so the existing enum / Top Online filter / chart groupings don't break. Web app gains a "Hide dead" filter toggle and a 💀 emoji prefix on dead rows.
- **Dry-run available**: `python scripts/mark_dead_games.py --dry-run --days 0` for auditing without writes.
- New helper `append_note_idempotent()` in `scripts/core/data_store.py`. Retrofitted onto `check_dead_links.py` to fix duplicate `"💀 Delisted"` accumulation on reruns.
- Schema migration via `_SKELETON_TEMPLATE` only (no one-shot script). Both the Python pipeline and the React app inherit defaults via existing `migrate_record()` / `migrateRecord()` loops.
## 🔄 Concurrency unification
All data-mutating workflows now share `concurrency: { group: data-write, cancel-in-progress: false }`:
- `update-json`, `update-daily`, `top-online`, `update-reviews`
- `check-dead-links`, `purge-unhealthy`, `mark-dead-games` (new)
- `ingest-new`, `ingest-from-issue`, `bot-ingest`, `refetch-all`
Prevents races on `git push` to `data/` shards. Bot-ingest moved from its own `bot-ingest` group to the unified group.
## 📝 Docs + contributor surface (this PR)
- **`AUTHORS.md`** at repo root — handle map for the maintainer, AI-assistant disclosure, MIT licensing reminder.
- **`username.txt`** extended with `telegram bot`, `telegram user`, and `email` lines (canonical machine-readable handle map mirrored by `AUTHORS.md`).
- **`assets/qr/`** — QR-code PNGs for `@my_skull_bot` and `@SkullMute0011` (mirrored to `web/public/qr/` so the SPA can serve them). Generated via `python -m qrcode`.
- **`web/src/pages/About.tsx`** — Maintainer card now lists Telegram bot + Telegram DM (with QR thumbnails inline) + Email. New "Telegram QR codes" card with full-size scannable codes. Privacy note about Telegram `user_id` handling.
- **`CONTRIBUTING.md`** rewrite — adds the `@my_skull_bot` flow as a first-class contribution path (find `user_id` → DM maintainer privately → whitelist → run when bot's online → follow prompts). Loud privacy warning at the top.
- **`docs/PRIVACY_POLICY.md`** — new "Telegram bot" section covering the `user_id` data flow, where it's stored, retention/removal, and the maintainer's commitment.
- **`docs/ToS.md`** — new section 5.1 "Sharing personal information when contributing" with non-negotiable rules about private vs public channels.
- **`docs/Contact.md`** — Telegram bot + DM entries added at the top.
- **README** badges and feature list refreshed (version bumped, dead-game workflow listed, About-page QR card mentioned).
## 🔢 Versioning
| Surface | Old | New |
|---|---|---|
| Repo public-facing | 3.0.1 | **3.1.0** |
| `web/package.json` | 1.0.0 | **1.1.0** |
| `web/src-tauri/Cargo.toml` | 1.0.0 | **1.1.0** |
| `web/src-tauri/tauri.conf.json` | 1.0.0 | **1.1.0** |
| Git tag (signed) | `v3.0.1` | `v3.1.0` |
| Desktop tag (signed) | `desktop-v1.0.0` | `desktop-v1.1.0` |
+74
View File
@@ -0,0 +1,74 @@
# v3.2.0 – 2026-05-11 (The "SEO + Donate + Auto-Discussion + Health Polish + Dev Docs" Edition)
[All versions](../../../CHANGELOG.md)
Single-PR bundle (#64) shipping eight features on top of v3.1.0. Web app + desktop bumped from `1.1.0` → `1.2.0`. Repo public-facing version `3.1.0` → `3.2.0`. Tag `v3.2.0` is GPG-signed; companion desktop tag is `desktop-v1.2.0`.
## 🔍 SEO basics
- `web/index.html` — full Open Graph block (`og:type`, `og:title`, `og:description`, `og:url`, `og:image`, `og:site_name`, `og:locale` + alternate), Twitter Card (`summary`), `<link rel="canonical">`, `meta name="author"`, JSON-LD (`WebSite` + `Person` + `SoftwareApplication`).
- New `web/public/robots.txt` (allow all + sitemap pointer) and `web/public/sitemap.xml` (5 entries: site root, GitHub repo, all-games / top-online / changelog markdown).
- New hook `web/src/hooks/useDocumentTitle.ts` — sets `document.title` to `<page> · Steam F2P Tracker` and re-runs on language change. Wired into all 18 routes (Dashboard / Games / TopOnline / Health / Activity / Add / About / Donate / Settings / 9 charts).
- VitePWA already emits `manifest.webmanifest` from `vite.config.ts`; no manual manifest needed.
## 💬 Auto-create GitHub Discussion on release
- New `.github/workflows/announce-release-discussion.yml` — fires on `release: published` (plus `workflow_dispatch` with a `tag` input for re-runs).
- Implemented via `actions/github-script@v8` + GraphQL `createDiscussion` (REST has no equivalent).
- Resolves the discussion category by slug — defaults to `Announcements`, falls back to `General` with a logged warning, then to the first available category.
- **Idempotent**: a GraphQL search runs first; if a discussion with the same title exists, the workflow skips with `core.notice()` and returns the existing URL via output. Re-running `workflow_dispatch` is therefore a no-op.
- Permissions: `contents: read`, `discussions: write` — both granted by `GITHUB_TOKEN` defaults once Discussions is enabled on the repo.
## 💖 Donate page
- New `web/src/pages/Donate.tsx` route at `/donate` — grid of 5 platform cards (GitHub Sponsors, Ko-fi, Buy Me a Coffee, Patreon, PayPal) sourced from `.github/FUNDING.yml`.
- Each card has a tinted icon ring, label, short description, and an "Open" button (`target="_blank" rel="noopener noreferrer"`).
- New nav item in `web/src/components/layout/Sidebar.tsx` SECONDARY group (between About and Settings); `Heart` icon from lucide.
- Full EN + VI i18n keys under `donate.*` (title / subtitle / cta / footnote + per-platform label & desc).
## 📖 Dev docs
- New `docs/pc_spec.md` (EN) + `docs/i18n/vi/pc_spec.md` (VI) — maintainer hardware spec mirroring `E:\spec.txt` (CPU / GPU / RAM / IDE) plus iPhone test-device list.
- New `docs/dev_env.md` (EN) + `docs/i18n/vi/dev_env.md` (VI) — IDE map (PyCharm / WebStorm / RustRover 2026.x), toolchain table (Python 3.12 / Node ≥ 22 / Rust stable / Tauri 2), per-area dev workflow (web / Tauri / Python pipeline), Git + GPG conventions, branch + PR flow.
- New `web/src-tauri/TAURI.md` — desktop build prerequisites (incl. CI's exact `apt-get` line), local + production build commands, signing + auto-update notes, troubleshooting.
- `AUTHORS.md` — new "Dev info" table (GitHub handle, IDE channel, toolchain versions, link map to all the above).
- README "Docs" section — links the four new docs.
## 🤖 Telegram bot user-guide pointer
- New `docs/telegram-bot.md` — one-page pointer to the external [`telegram-scraper-bot/docs/USER_GUIDE.md`](https://github.com/poli0981/telegram-scraper-bot/blob/main/docs/USER_GUIDE.md), bot source repo, plus a paragraph each on what the bot does and the whitelist lifecycle.
- `CONTRIBUTING.md` — section 3 (`@my_skull_bot`) gets a 3-line callout with the user guide link, bot source URL, and the new in-repo summary doc.
- `web/src/pages/About.tsx` — Maintainer card's privacy note now includes a "Bot user guide & source" sub-card with the same three links.
## 🩺 Health bucket split
- `web/src/pages/Health.tsx` — `gatherIssues()` adds a fifth `IssueGroup`: `OnlineAcUnknown` for games with `type_game === "online"` and `anti_cheat ∈ {"", "-"}`. Previously these games were silently dropped from all categories; now they have a discoverable home.
- Edge-case fix: the existing "Kernel" filter compared `(r.anti_cheat ?? "-") !== "-"`, missing the empty-string case. Both filters now use a normalised `(r.anti_cheat ?? "").trim()`.
- `ShieldQuestion` icon (lucide). EN + VI i18n keys: `health.groupOnlineAcUnknown` + `…Desc`.
## 🎮 Steam Desktop direct link
- New helper `web/src/lib/steam-link.ts` — `steamProtocolUrl(appid)` returns `steam://store/<appid>`, `steamWebUrl(appid)` returns the regular HTTPS store URL.
- `web/src/components/games/GameDetailDrawer.tsx` — single store link replaced by two buttons rendered side-by-side: a primary "Steam Desktop" (`steam://`) and an outline "Web" (`https://`). Tooltip on the desktop button explains the fallback path.
- Works in both web build (browser shows protocol prompt if Steam is installed, silent fail otherwise — Web button is the safety net) and Tauri build (Tauri 2 allows `steam://` navigation by default; no allow-list change needed).
- EN + VI i18n: `detail.openOnSteamDesktop`, `detail.openOnSteamDesktopHint`, `detail.openOnSteamWeb`.
## 🛌 Bi-weekly offline-player leaderboard
- New `scripts/top_offline.py` — clones the `top_online.py` shape but filters `_is_offline(g)` (non-empty `type_game ≠ "online"`). Emits `games/top-offline.md` (top 100 single-player F2P concurrents, 10-column format identical to top-online).
- Calibrated tier thresholds (`_TIERS`) lower than online (offline games rarely break 6-figure concurrents) — `🔥 Mega ≥ 20k`, `⭐ Hot ≥ 5k`, `🟢 Healthy ≥ 1.5k`, `🟡 Stable ≥ 300`, `🟠 Low ≥ 50`, `🔴 Quiet ≥ 10`, `💀 Idle <10`.
- New `bash/offline.sh` matches the shape of `bash/online.sh` (pip install requests → run script → conditional commit).
- New `.github/workflows/top-offline.yml` — cron `0 5 1,15 * *` (1st + 15th of each month at 05:00 UTC) plus `workflow_dispatch`. Shares the unified `data-write` concurrency group.
- Health page (`web/src/pages/Health.tsx`) — new manual trigger button "Top offline" (next to the existing "Top online" trigger).
- **Bug fix during implementation**: `scripts/core/fetcher.py:update_players_only()` had a hardcoded `type_game == "online"` filter that would have made the offline workflow refresh zero rows. Extended with a `type_filter` kwarg (`"online"` default for backward compat, `"offline"`, or `"all"`); `top_offline.py` passes `type_filter="offline"` (excludes both online and empty/unclassified type).
## 🔢 Versioning
| Surface | Old | New |
|---|---|---|
| Repo public-facing | 3.1.0 | **3.2.0** |
| `web/package.json` | 1.1.0 | **1.2.0** |
| `web/src-tauri/Cargo.toml` | 1.1.0 | **1.2.0** |
| `web/src-tauri/tauri.conf.json` | 1.1.0 | **1.2.0** |
| Git tag (signed) | `v3.1.0` | `v3.2.0` |
| Desktop tag (signed) | `desktop-v1.1.0` | `desktop-v1.2.0` |
+20
View File
@@ -0,0 +1,20 @@
# v3.2.1 – 2026-05-11 (The "Genre Cleanup" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.0. Normalizes inconsistent `genre` values across the dataset (31 records, 10 canonical mappings) and broadens the webapp's genre combobox with 14 additional suggestions. Web app + desktop bumped `1.2.0` → `1.2.1`. Repo public-facing version `3.2.0` → `3.2.1`. Tag `v3.2.1` is GPG-signed; companion desktop tag is `desktop-v1.2.1`.
## 🧹 Genre normalization script
- New `scripts/normalize_genres.py` — local one-shot tool with `--apply` flag (dry-run by default). Reuses `core.data_store.load_main` / `save_main` so writes are atomic + sharded.
- Canonical mappings applied (sentence-case style for compounds): `Hack and Slash` → `Hack & Slash` (4), `Third-Person Shooter` → `Third-person Shooter` (7), `Top-Down Shooter` → `Top-down Shooter` (3), `Turn-Based Strategy` → `Turn-based Strategy` (3), `Turn-Based Tactics` → `Turn-based Tactics` (4), `Turn-Based Combat` → `Turn-based Combat` (2), `Shoot 'Em Up` / `Shoot'em up` → `Shoot 'em up` (5), `Point-and-Click` → `Point & Click` (1), `Rougelite` → `Roguelite` (2 typo).
- 31 records updated · 10 unique canonical changes · unique-genre count 100 → 92.
- Idempotent — second run reports "data already canonical".
- Comma-separated values like `"Action RPG, Gacha"` (Wuthering Waves, Honkai Impact 3rd) are flagged in a "Manual review needed" section rather than auto-split, since the schema is single-genre.
- All `games/*.md` regenerated via `scripts/generate_tables.py`; affected genre files include the new sentence-case slugs (`turn-based-strategy.md`, `top-down-shooter.md`, `third-person-shooter.md`, `roguelite.md`, etc.).
## 🎛 Webapp genre dropdown additions
- `web/src/lib/enums.ts` — `GENRE_ENUM` extended from 44 → 58 entries. Added 14 sub-genres already common in the data: `Action RPG`, `Beat 'em up`, `Bullet Hell`, `Clicker`, `Hidden Object`, `Real-Time Strategy`, `Roguelite`, `Survival Horror`, `Tactical RPG`, `Third-person Shooter`, `Top-down Shooter`, `Turn-based RPG`, `Turn-based Strategy`, `Turn-based Tactics`.
- Sentence-case style matches the normalized data values.
- Dropdown filter on `web/src/pages/Games.tsx` is facet-driven (auto-updates from the records), so it now shows the deduplicated canonical names. The `EditGameDrawer` combobox suggests the 14 new entries while still accepting free-text input.
+28
View File
@@ -0,0 +1,28 @@
# v3.2.2 – 2026-05-11 (The "Bug Fix Quartet" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.1. Four user-reported bug fixes touching the Ctrl+K command palette on desktop, the Health → Games navigation flow, Tauri process-stacking on every launch, and the `type_game` scraper that was defaulting every new game to `"offline"`. Web app + desktop bumped `1.2.1` → `1.2.2`. Repo public-facing version `3.2.1` → `3.2.2`. Tag `v3.2.2` is GPG-signed; companion desktop tag is `desktop-v1.2.2`.
## 🔗 Desktop Ctrl+K external link
- New `web/src/lib/external-open.ts` — lazy-detects the Tauri runtime via `__TAURI_INTERNALS__`, opens external URLs through `@tauri-apps/plugin-shell` on desktop (capability `shell:allow-open` already granted in `web/src-tauri/capabilities/default.json`), falls back to `window.open(url, "_blank", "noopener,noreferrer")` on web/PWA. Plugin module is lazy-imported, so the web bundle never pays for the Tauri code path.
- `web/src/components/common/CommandPalette.tsx` — Ctrl+K game results now route through `openExternal()`. The Tauri webview was silently blocking the raw `window.open(r.link, "_blank")` for external HTTPS URLs, so clicking a search result on desktop did nothing.
- Six other `window.open(...)` call sites (Health workflow link, Add, BulkActionBar, BulkEditDrawer, EditGameDrawer, DeviceFlowPanel) are flagged for follow-up migration to `openExternal()` — same desktop silent-fail will hit them when triggered.
## 🩺 Health → Games filter restoration
- `web/src/pages/Games.tsx` — adds `useSearchParams` + a `useEffect` that mirrors the URL `?search=` parameter into `useFilters.search` on mount. The Health page already linked rows to `#/games?search=<name>`, but Games never read the param, so the table stayed unfiltered and the Topbar input stayed empty. The store binding to Topbar means visual feedback is automatic once the filter is set.
- Guard `if (term !== null)` (instead of `if (term)`) lets `?search=` explicitly clear the filter — useful for shareable "no filter" links.
## 🪟 Tauri single-instance enforcement
- `web/src-tauri/Cargo.toml` — adds `tauri-plugin-single-instance = "2"` under the existing desktop-only `cfg(not(any(target_os = "android", target_os = "ios")))` block, matching the updater plugin's gating pattern.
- `web/src-tauri/src/lib.rs` — registers single-instance as the **first** plugin so it short-circuits duplicate launches before any other state initialises. The dup-launch callback calls `unminimize()` + `show()` + `set_focus()` on the existing `main` window. Without this, every Start-menu / shortcut / file-association invocation spawned a fresh `f2p-tracker.exe` that lingered in Task Manager.
- No capability changes needed — plugin runs entirely Rust-side, no frontend command exposed.
## 🎮 `type_game` online inference
- `scripts/core/fetcher.py` — new `_infer_type_game(categories)` reads `data.get("categories", [])` and returns `"online"` when any description contains `online`, `mmo`, `massively multiplayer`, `cross-platform multiplayer`, or `multi-player`. Pure `shared/split screen` descriptions are treated as local-only and skipped unless paired with another online signal.
- Wired into `apply_details()` next to the existing anti-cheat category loop, guarded by `is_empty(game.get("type_game"))` so manual prefills in `temp_info.jsonl` remain authoritative — the `MANUAL_FIELDS` merge in `data_store.merge_extension_data()` and the override re-apply in `ingest_new.py` are unchanged.
- The legacy default-to-`"offline"` at the end of `fetch_full()` stays as the final safety net for games with no multiplayer signal in Steam categories. New ingests of online F2P games now classify correctly instead of all-offline.
+26
View File
@@ -0,0 +1,26 @@
# v3.2.3 – 2026-05-17 (The "View Commit Toast + Offline AC Lock" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.2. Three user-reported fixes: the "View commit" action button in success toasts (now reachable + cross-platform), an editor lock that prevents anti-cheat fields from being set on offline games, and a broken `Mark dead games` workflow setup-python step. Web app + desktop bumped `1.2.2` → `1.2.3`. Repo public-facing version `3.2.2` → `3.2.3`. Tag `v3.2.3` is GPG-signed; companion desktop tag is `desktop-v1.2.3`.
## 🍞 View commit toast — clickable + desktop-safe
- Migrated the eight `window.open(commit.htmlUrl, "_blank")` action handlers in `EditGameDrawer.tsx` (2), `Add.tsx` (2 inside `reportToast`), `BulkEditDrawer.tsx` (2), and `BulkActionBar.tsx` (2) to `openExternal()` from `web/src/lib/external-open.ts` — completes the follow-up migration flagged in v3.2.2's CHANGELOG. The Tauri webview was silently blocking the raw `window.open(...)` for external HTTPS URLs, so "View commit" did nothing on desktop.
- Each `toast.success(...)` with a "View commit" action now sets `duration: 15000` (was Sonner's 4 s default). On web the old toasts auto-dismissed before the user could read the description + click the action button.
- Handler now accepts the click event and calls `event.preventDefault()` so the toast stays visible after click (Sonner's default is to dismiss on action click — undesirable when the user wants to glance at the SHA after opening the commit).
- The fix applies to both the initial `toast.success` and the follow-up emit fired by `pollCommitVerification(...).then(...)` (same toast `id`, so `duration` must be set on the update too — otherwise the second emit rebounds to the 4 s default).
## 🔒 Anti-cheat fields lock on offline games
- `web/src/components/games/EditGameDrawer.tsx` — `FormFields` derives `lockAC = form.type_game === "offline"` and threads `disabled={lockAC}` to the AC `<select>`, the custom-AC `<Input>`, the three kernel `<Button>`s, and the AC note `<Textarea>`. A muted hint is rendered under the AC note when locked, explaining how to re-enable.
- `update()` setter now auto-resets `anti_cheat=""`, `anti_cheat_note=""`, `is_kernel_ac="unknown"` when `key === "type_game" && value === "offline"`. This keeps the `formToPatch()` diff honest — switching an online game with AC populated to offline now produces an explicit AC-clear in the commit instead of orphan anti-cheat data on an offline record.
- `web/src/pages/Add.tsx` — same pattern in `OverrideFields` + the `SingleAdd.setOv()` setter. `OverrideFields` combines the existing busy-state `disabled` prop with the new lock via `acDisabled = disabled || lockAC`, so the global "form is submitting" disable still wins. BulkAdd uses raw text / JSON input, so no UI lock needed there.
- `type_game === ""` (unknown) deliberately does **not** lock — only an explicit `"offline"` triggers the gate. The existing `validation.ts` "kernel?" badge rule for online + missing-kernel is untouched.
- New i18n key `edit.acLockedOffline` added to `web/src/i18n/locales/en.json` and `vi.json`, rendered as a `text-xs text-muted-foreground` hint under the AC note when `lockAC` is true.
## 🪦 `Mark dead games` workflow path fix
- `.github/workflows/mark-dead-games.yml` — `cache-dependency-path: scripts/requirements.txt` and the subsequent `pip install -r scripts/requirements.txt` both pointed at a path that doesn't exist. The file lives at the repo root (`requirements.txt`), consistent with the path `codeql.yml:25` already uses.
- Fix: both lines now reference `requirements.txt` at the root. The `setup-python` cache lookup no longer errors with `No file in /home/runner/work/free-steam-games-list/free-steam-games-list matched to [scripts/requirements.txt or **/pyproject.toml]`, and the install step actually finds the deps.
- Workflow is scheduled Mon + Thu 04:30 UTC; the next scheduled run will be the first end-to-end verification, but `workflow_dispatch` with `dry_run=true` is also available for ad-hoc validation.
+63
View File
@@ -0,0 +1,63 @@
# v3.2.4 – 2026-05-20 (The "Refactor + Removed-Games + Anti-Cheat Index" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.3, landed as two PRs. **PR #74 (cleanup):** two dead scripts removed, `EditGameDrawer.tsx` (718 LOC) and `GamesTable.tsx` (568 LOC) split into focused sub-modules, two new charts (`TopOfflineBar`, `AddedPerMonthBar`) wired to a fresh `/top-offline` page and the existing `/charts/time` page. **PR #75 (features):** the `scripts/removed_games.jsonl` log now passes through a `dedup_removed()` filter on every write (a one-time migration trimmed 6 historical duplicates), Top Online leaderboard expanded `50 → 100` to match Top Offline, a generated `games/anti-cheat-list.md` plus a `/charts/anti-cheat/list` web page group active games by anti-cheat family, and a new `/charts/delisted` page renders a timeline + reason breakdown of every removed-from-catalogue title. Web app + desktop bumped `1.2.3` → `1.2.4`. Repo public-facing version `3.2.3` → `3.2.4`. Tag `v3.2.4` is GPG-signed; companion desktop tag is `desktop-v1.2.4`.
## 🧹 Dead-script removal
- `scripts/discord_notify.py` deleted — superseded by the `poli0981/.github` reusable workflow; no `.github/workflows/*.yml` or `bash/*.sh` referenced it.
- `scripts/migrate_to_shards.py` deleted — one-shot v2.2 migration tool, completed and unreferenced. The 10-script "unreferenced in workflows" audit confirmed the other eight (`check_dead_links`, `delete_game`, `normalize_genres`, `purge_unhealthy`, `top_offline`, `top_online`, `update_data`, `update_reviews`) all have live `bash/*.sh` wrappers and stay.
## 🪓 Component splits
- `web/src/components/games/EditGameDrawer.tsx` (718 LOC) → 7 focused files under `edit/`:
- `EditGameDrawer.tsx` keeps the save handler, dialog shell, view-toggle wiring.
- `EditFormFields.tsx`, `EditJsonView.tsx` (with `JsonDiff`), `EditChangePreview.tsx`, `ViewToggle.tsx` extract the four UI regions.
- `form-utils.ts` exports `gameToForm` + `formToPatch`; `types.ts` re-exports the `FormState` + `View` types.
- `web/src/components/games/GamesTable.tsx` (568 LOC) → container + 5 files under `table/`:
- `GamesTable.tsx` keeps the virtualizer (`useVirtualizer` ownership at container level so row-height stays single-source), filters, fuzzy search, sort, and paging.
- `columns.tsx` extracts the `COLS: ColDef[]` array (12 columns) + `TOTAL_WIDTH` + `SELECT_COL_WIDTH` constants.
- `TableHeader.tsx`, `TableRow.tsx` (memoised with `React.memo`), `TableToolbar.tsx`, `ExportMenu.tsx` extract the visual regions.
- No behaviour change — same virtual scrolling, same sort/filter wiring, same selection store.
## 📊 New charts
- `web/src/components/charts/TopOfflineBar.tsx` — mirror of `TopOnlineBar` but with offline-tier thresholds (20k/1.5k/300) calibrated to the `top_offline.py` scale instead of the online-only 100k/10k/1k palette. Filters `type_game !== "online" && status === "active"`, top 100 by `current_players`.
- `web/src/pages/TopOffline.tsx` — new page at `/top-offline`, layout mirror of `TopOnlinePage`, registered in `App.tsx` and `Sidebar.tsx` (Trophy icon).
- `web/src/components/charts/AddedPerMonthBar.tsx` — aggregates `records[*].added_at` into `YYYY-MM` buckets, renders an ECharts bar. Added as a third card to the existing `charts/Time.tsx` page alongside `ReleaseYearHistogram` + `AddedCumulativeLine`.
## 🗑️ Removed-games dedup
- `scripts/core/data_store.py` — new `dedup_removed(records)` keeps the latest entry per appid (compared by `removed_at` ISO timestamp, lexicographic order matches chronological for `YYYY-MM-DDTHH:MM:SSZ`). Records without a resolvable appid are dropped.
- `scripts/purge_unhealthy.py:41-43` and `scripts/ingest_new.py:106-108` — both call sites now write `dedup_removed(existing + log)` instead of `existing.extend(log)`. Same `save_jsonl` atomic-rename transaction, so partial writes can't leave duplicates.
- `scripts/dedup_removed_games.py` (new) — one-shot CLI that loads, dedups, and rewrites the file. Run once locally as part of this release; idempotent, safe to re-run.
- Result: existing log trimmed `43 → 37` records. Verified zero duplicate appids post-migration.
## 🏆 Top Online expanded 50 → 100
- `scripts/core/constants.py:81` — `TOP_ONLINE_LIMIT = 100` (was 50). Top Offline already 100.
- `games/top-online.md` regenerated with 100 rows on next workflow tick; format unchanged (10-column table preserved).
- `web/src/pages/TopOnline.tsx` — `<TopOnlineBar limit={100} height={1800}>` to match the new row count.
- i18n strings `topOnline.{subtitle,cardTitle}` updated `Top 50 → Top 100` in both `en.json` and `vi.json`.
## 🛡️ Anti-cheat list
- `scripts/generate_anti_cheat_list.py` (new) — buckets active games by canonical AC name (`ANTI_CHEAT_PATTERNS` keys), with substring-match fallback for free-text values. Unrecognised values land in an `Other` bucket with a stderr warning. Output `games/anti-cheat-list.md`: H1 + TOC + per-family H2 sections, each a 6-column table sorted by `current_players` desc.
- `bash/anti_cheat.sh` + `.github/workflows/anti-cheat-list.yml` (new) — weekly Sunday 06:00 UTC cron + manual dispatch. Uses the same `data-write` concurrency group as the other table-generation workflows.
- `web/src/pages/AntiCheatList.tsx` (new) — `/charts/anti-cheat/list` page mirrors the MD: collapsible per-family sections + sticky AC-name sidebar nav. Uses existing `useGames` hook; canonicalises client-side via a TS port of the Python patterns table. i18n keys `antiCheatList.*` added to en + vi.
## 📉 Delisted charts
- `web/src/hooks/useRemovedGames.ts` (new) — fetches `scripts/removed_games.jsonl` from raw.githubusercontent.com, parses lines, deduplicates client-side (same logic as the Python dedup). TanStack Query with 5-minute staleTime.
- `web/src/components/charts/DelistedTimeline.tsx` (new) — ECharts stacked bar, x = `YYYY-MM` of `removed_at`, stacked by `status_code` (`not_free` / `unavailable` / fallback `other`).
- `web/src/components/charts/DelistedReasonBreakdown.tsx` (new) — ECharts donut by `status_code`.
- `web/src/pages/charts/Delisted.tsx` (new) — `/charts/delisted` page renders both charts. Sidebar nav link with `WifiOff` icon.
- `web/src/components/charts/KpiCards.tsx` — new optional `removedCount` prop; when set, renders a 7th "Removed (all-time)" KPI alongside the existing in-catalog "Delisted" badge. Wired from `Dashboard.tsx` via `useRemovedGames().data?.length`. Grid bumps from `xl:grid-cols-6` to `xl:grid-cols-7`.
## 📝 Docs
- README: removed the duplicate "Quick Links" section (the comprehensive 11-row "Quick links" table at the top covers everything the 4-row duplicate listed).
- README: added `🎯 Top offline (md)` row to the main Quick links table.
- README: version badge bumped `3.2.3` → `3.2.4`.
- i18n: combined `nav.{topOffline,antiCheatList,delisted}`, `topOffline.*`, `antiCheatList.*`, `charts.{time.addedPerMonth,delisted.*}` keys added to `en.json` + `vi.json`.
+30
View File
@@ -0,0 +1,30 @@
# v3.2.5 – 2026-05-20 (The "AC Nav + Mobile + Games Cleanup" Edition)
[All versions](../../../CHANGELOG.md)
Patch release on top of v3.2.4. One reported bug fix + three quality-of-life polish items. **Bug:** clicking any "Family" link in the Anti-Cheat Index sidebar redirected to the Dashboard instead of scrolling to the matching family table — `HashRouter` was treating the `<a href="#vac">` anchor as a route navigation. **Polish:** the `GamesTable` (1318 px wide) now degrades to a virtualised card list below the `md` breakpoint so mobile no longer needs horizontal scroll; the `AntiCheatList` sidebar drops to `md` instead of `lg` and exposes a horizontal chip nav on phones; `KpiCards` adds `md`/`lg` rungs to avoid uneven grid jumps. **Cleanup:** 93 per-genre markdown files in `games/` are removed (the web app's `/games?genre=X` filter has replaced them since v3.0); `generate_tables.py` now skips regeneration when game data hasn't actually changed via a `.gen-hash` checksum, cutting daily catalogue commits to roughly the days that move records. **New:** floating back-to-top button on the main scroll container, fades in past 400 px. Web app + desktop bumped `1.2.4` → `1.2.5`. Repo public-facing version `3.2.4` → `3.2.5`. Tag `v3.2.5` is GPG-signed; companion desktop tag is `desktop-v1.2.5`.
## 🔗 AC Index sidebar navigation fix
- [web/src/pages/AntiCheatList.tsx](../../../web/src/pages/AntiCheatList.tsx): swap `<a href="#anchor">` for `<button onClick>` that calls `document.getElementById(id).scrollIntoView({ behavior: "smooth", block: "start" })`. The `id={anchor}` attribute on each family `<Card>` stays the same — only the click target changes.
- Root cause: `main.tsx:24` uses `HashRouter`. Anchor links inside a hash-routed page produce URLs like `#/charts/anti-cheat/list#vac`. HashRouter parses the trailing `#vac` as a fresh route, the regex doesn't match, and the `<Route path="*" element={<Navigate to="/" replace />}>` fallback in `App.tsx` sends the user to the Dashboard.
- Same fix applied to the new mobile chip nav (below) so behaviour is uniform across viewports.
## 📱 Mobile responsive
- New `web/src/components/games/table/MobileGameCards.tsx` — virtualised card list rendering one card per game with thumb, name, genre/type/AC/status badges, review %, current players, and a Steam-link icon. Shares filter/sort/page state with the desktop table via the existing `useFilters` store.
- [`GamesTable.tsx`](../../../web/src/components/games/GamesTable.tsx) wraps the desktop scroll container in `hidden md:block` and renders `<MobileGameCards>` inside `md:hidden`. No new state, no behaviour drift between views.
- [`AntiCheatList.tsx`](../../../web/src/pages/AntiCheatList.tsx) sidebar changes from `hidden w-48 shrink-0 lg:block` to `hidden md:block md:w-40 lg:w-48` — visible on tablets too. Below `md`, a horizontal scrollable chip rail above the content provides the same family-jump nav.
- [`KpiCards.tsx`](../../../web/src/components/charts/KpiCards.tsx) grid `sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-7` → `sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-7`. Inserts `md` (tablet, 3 cols) and `lg` (small laptop, 4 cols) rungs so the 7 KPIs don't double-stack awkwardly.
## 🧹 `games/` cleanup + smart regen
- **Deleted 93 per-genre `<genre>.md` files** (`action.md`, `fps.md`, `visual-novel.md`, …). Web app `/games?genre=X` is the canonical genre filter since v3.0; no inbound link audit hit anything beyond `games/README.md` (regenerated) and the now-stale "By Genre" section in the index. Files kept: 11 × `all-games_part*.md`, `top-online.md`, `top-offline.md`, `anti-cheat-list.md`, `README.md`.
- [`scripts/generate_tables.py`](../../../scripts/generate_tables.py) drops the genre loop entirely and rewrites the `games/README.md` template to point at part files + leaderboards + AC list, with a one-line note about the web-app genre filter.
- **Smart regen via `.gen-hash`** — script computes `sha256` of sorted `(link, name, genre, reviews, current_players, anti_cheat, is_kernel_ac, status)` tuples and writes the digest to `games/.gen-hash`. Subsequent runs short-circuit (`Skip: no semantic changes (hash=...)`) when the hash is unchanged. Order-invariant, ignores timestamps embedded in MD output, so daily workflow ticks only commit when game data actually moves.
## ⬆️ Back-to-top button
- New `web/src/components/common/BackToTop.tsx` — a fixed-position icon button bottom-right of the viewport. Listens for `scroll` events on the passed scroll container ref (passive listener), fades in (`opacity-100`) past 400 px, becomes pointer-events-none below to avoid blocking click-through.
- [`Layout.tsx`](../../../web/src/components/layout/Layout.tsx) creates a `useRef<HTMLElement>` on `<main>`, passes it as `scrollRef`. Single mount, no per-page wiring.
- i18n: `common.backToTop` added to `en.json` ("Back to top") and `vi.json` ("Lên đầu trang") for `aria-label` + `title`.
+16
View File
@@ -0,0 +1,16 @@
# v3.2.6 – 2026-05-20 (The "Mobile Hotfix" Edition)
[All versions](../../../CHANGELOG.md)
Hotfix on top of v3.2.5. Two mobile-viewport regressions introduced by the v3.2.5 responsive overhaul. Web app + desktop bumped `1.2.5` → `1.2.6`. Repo public-facing version `3.2.5` → `3.2.6`. Tag `v3.2.6` is GPG-signed; companion desktop tag is `desktop-v1.2.6`.
## 🐛 AC Index table — horizontal scroll on mobile
- `web/src/pages/AntiCheatList.tsx` — the per-family table wrapper was `<div className="overflow-hidden rounded-md border">`. On a 390 px viewport the 5-column table (`# / Game / Genre / Kernel / Players`) is wider than the card, and `overflow-hidden` clipped the right-hand columns with no way to scroll to them.
- Fix: `overflow-hidden` → `overflow-x-auto`. The table now scrolls horizontally when it exceeds the viewport, and the scrollbar stays hidden when it fits.
## 🖼️ Mobile game cards — thumbnail fallback
- `web/src/components/games/table/MobileGameCards.tsx` — the card `<img>` loads `headerToCapsule(g.header_image)` (the smaller `capsule_184x69.jpg` variant, ~10 KB vs ~50 KB). Steam's CDN doesn't host that variant for every game, so those cards rendered a blank thumbnail.
- The desktop table column (`table/columns.tsx`) already had an `onError` handler that falls back to the original `header.jpg`; the v3.2.5 mobile card component didn't port it. `GameDetailDrawer` uses `g.header_image` directly, which is why the image always appeared once a card was tapped.
- Fix: add the same `onError` fallback to the mobile card `<img>` — on a 404 it swaps `src` to `g.header_image`, with an `el.src !== g.header_image` guard against an infinite error loop.
+35
View File
@@ -0,0 +1,35 @@
# v3.2.7 – 2026-05-22 (The "Coming-Soon Guard + Dead-Code Cleanup" Edition)
[All versions](../../../CHANGELOG.md)
Maintenance release on top of v3.2.6. A small, useful batch: the Python pipeline now rejects unreleased ("coming soon") games at ingest instead of listing titles nobody can play yet; a one-time dead-code sweep across the web app and the pipeline; and three dev-tooling additions (knip, vulture, pip-audit) so future releases can run the same checks. Web app + desktop bumped `1.2.6` → `1.2.7`. Repo public-facing version `3.2.6` → `3.2.7`. Tag `v3.2.7` is GPG-signed; companion desktop tag is `desktop-v1.2.7`.
## 🚧 Coming-soon games rejected at ingest
- `scripts/core/health_checker.py` — new `COMING_SOON` status, added to the `REMOVABLE` set. `check_game_health()` now reads the Steam `appdetails` flag `release_date.coming_soon` right after the API response resolves (before the `is_free` check) and returns `HealthResult(COMING_SOON, …)` for unreleased titles.
- Effect: `ingest_new.py` rejects coming-soon entries from the queue and logs them to `removed_games.jsonl` with reason "Not yet released (coming soon)" — the same path `NOT_FREE` already uses. `purge_unhealthy.py`'s weekly scan likewise evicts any coming-soon title already in the dataset.
- Rationale: an F2P *games* tracker should list playable titles. A coming-soon game has zero players, no reviews, and an unconfirmed price (it can launch paid). The API flag is used instead of scraping the `game_area_comingsoon` HTML block — it's already fetched during the health check and is authoritative. No schema change.
## 🧹 Web dead-code cleanup (knip)
- New `knip` sweep (config in `web/knip.json`). Removed two unused files: `src/components/common/UpdateChecker.tsx` — the Tauri auto-update component, never wired into `Layout.tsx` since Phase 9, so the frontend update check never actually ran — and `src/components/ui/switch.tsx`, an unused shadcn primitive.
- Removed 11 unused dependencies from `web/package.json`: 7 Radix primitives (`react-dropdown-menu`, `react-scroll-area`, `react-select`, `react-switch`, `react-tabs`, `react-toast`, `react-tooltip`), `@tanstack/react-table` (the virtualised table uses only `@tanstack/react-virtual`), and 3 Tauri packages (`@tauri-apps/api`, `@tauri-apps/plugin-process`, `@tauri-apps/plugin-updater` — the last two were referenced only by the removed `UpdateChecker`).
- `vite.config.ts` — dropped the now-stale `@tanstack/react-table` entry from the `manualChunks.table` group.
- knip's remaining "unused export" findings inside the `src/lib/*` port modules are intentional API surface; they're set to `warn` so `npm run knip` stays green.
## 🧹 Python dead-code cleanup (vulture)
- Deleted `scripts/dedup_removed_games.py` — the one-shot v3.2.4 migration, completed and now redundant (`dedup_removed()` runs inside the pipeline on every write). Same rationale as v3.2.4's removal of `migrate_to_shards.py`.
- `scripts/core/data_store.py` — dropped the unused `EXTENSION_FIELDS` import. The constant stays defined in `constants.py` as the documented MANUAL/ARRAY/EXTENSION field-class trio (mirrored in `web/src/lib/schema.ts`).
- `scripts/core/steam_client.py` — `__exit__(self, *a)` → `__exit__(self, *_)` (idiomatic unused-varargs name).
## 🧰 Dead-code & audit tooling
- **knip** — `web/package.json` devDependency + `npm run knip` script + `web/knip.json`. Finds unused files / exports / dependencies in the TypeScript SPA.
- **vulture** + **pip-audit** — new `requirements-dev.txt`; vulture config in a new root `pyproject.toml` (`[tool.vulture]`, `min_confidence = 80`). Python dead-code detection + dependency CVE audit.
- All three run at dev time only — nothing new ships in the pipeline, web bundle, or desktop app.
## 📄 Docs
- New `docs/THIRD_PARTY.md` — documents the dev tooling above (purpose, license, where declared) and the canonical pre-publish check suite. Linked from the README "Docs" section.
- Synced the third-party dependency lists to the removals above — `docs/ACKNOWLEDGEMENTs.md`, the in-app `/about` page (`web/src/pages/About.tsx`), and `web/README.md` no longer list the dropped Radix primitives, `@tanstack/react-table`, or `@tauri-apps/api`.
+46
View File
@@ -0,0 +1,46 @@
# v3.3.0 – 2026-06-12 (The "Lazy-Load + Error Pages" Edition)
[All versions](../../../CHANGELOG.md)
Feature release on top of v3.2.7, two themes: a web-app performance overhaul (route-level code splitting, lazy echarts/openpgp/locale chunks — first-load JS drops from ~574 KB to ~163 KB gzipped, −72%) and a proper error-page system (403/404/419/5xx/offline pages, React error boundaries, a real GitHub Pages `404.html`). Web app + desktop bumped `1.2.7` → `1.3.0`. Repo public-facing version `3.2.7` → `3.3.0`. Tag `v3.3.0` is GPG-signed; companion desktop tag is `desktop-v1.3.0`.
## ⚡ Lazy-loading overhaul
- **Route splitting** — [web/src/App.tsx](../../../web/src/App.tsx): every page except `Dashboard` (the landing route) is now `React.lazy` via a new `lazyWithRetry` helper ([web/src/lib/lazy.ts](../../../web/src/lib/lazy.ts)). The `<Suspense>` boundary sits inside [Layout.tsx](../../../web/src/components/layout/Layout.tsx) around `<Outlet/>`, so the sidebar/topbar stay mounted during navigation; fallback reuses the existing `LoadingState`.
- **echarts (~666 KB raw)** — new [LazyEChart.tsx](../../../web/src/components/charts/LazyEChart.tsx) wrapper is the single dynamic boundary for `EChart.tsx` (which keeps the `echarts.use([...])` registration). All 15 chart components swap one import line; a fixed-height `animate-pulse` skeleton prevents layout shift. echarts now downloads only when a chart mounts.
- **openpgp (~391 KB raw)** — [web/src/lib/gpg.ts](../../../web/src/lib/gpg.ts) switches to a type-only import + memoized `await import("openpgp")`. All exports were already async, so zero caller changes; visitors without a saved GPG key never download the crypto chunk at all.
- **Per-locale i18n** — [web/src/i18n/index.ts](../../../web/src/i18n/index.ts): `en.json` stays bundled (it's `fallbackLng` — a missing key can never render raw), `vi.json` becomes a dynamic import. `initI18n()` preloads the detected locale before `i18n.init`, and [main.tsx](../../../web/src/main.tsx) awaits it before first render — no flash of raw keys, verified with a hard reload under `f2p:lang=vi`. `setLanguage()` is now async and loads the bundle *before* switching. Also syncs `<html lang>` (was hardcoded `vi` for everyone).
- **manualChunks fix** — forcing `echarts`/`openpgp` into `manualChunks` made Rollup hoist shared helpers (tslib) *into* the echarts chunk, which the eager graph then statically imported — echarts was being modulepreloaded on first paint, nullifying the lazy boundary. Both entries are removed from [vite.config.ts](../../../web/vite.config.ts); the dynamic-import boundaries split them naturally. `dist/index.html` now modulepreloads only `react` + `query`.
- Net effect: eager JS `~1746 KB → ~494 KB` raw (`~574 → ~163 KB` gzip). The PWA still precaches everything in the background, but first paint no longer waits for charts + crypto.
## 🚦 Error pages (403 / 404 / 419 / 500 / 502 / 503 / 504 / offline)
- New [web/src/pages/errors/ErrorPage.tsx](../../../web/src/pages/errors/ErrorPage.tsx) — one config-driven component: per-code lucide icon + tone (neutral/warn/destructive, reusing the exact `ErrorState`/`PwaIndicator` palettes), mono `ERROR {{code}}` badge, i18n'd title/description, and three actions (Go home / Reload / Report issue → GitHub Issues). Full `errors.*` key blocks added to both [en.json](../../../web/src/i18n/locales/en.json) and [vi.json](../../../web/src/i18n/locales/vi.json). Kept in the eager bundle on purpose — error UI must not live in a lazy chunk.
- Routing — `#/error/:code` deep links via `ErrorCodeRoute` (unknown codes render 404 in place, no redirect), and the catch-all `<Route path="*">` now shows a real 404 page instead of silently redirecting to the Dashboard.
- **GitHub Pages `404.html`** — new [web/public/404.html](../../../web/public/404.html): standalone dark page (inline CSS, no JS deps), bilingual via a one-liner that respects the app's own `f2p:lang`, `noindex`, absolute link back to `/free-steam-games-list/#/`. Excluded from the SW precache via `globIgnores` in [vite.config.ts](../../../web/vite.config.ts) — SW-controlled clients get `navigateFallback` and never see it.
## 🛡️ Error boundaries + stale-deploy resilience
- New [ErrorBoundary.tsx](../../../web/src/components/common/ErrorBoundary.tsx) (own ~40-line class, no new dep) with a `resetKey` prop — navigating away clears a stuck error *without* remounting the page subtree on every navigation (which `key` would do, destroying table scroll/selection state).
- Two mounts: route-level inside `Layout` (chunk-load error → 503 page with "new version deployed, reload" copy; render crash → 500 page, error message shown in dev only), and a top-level [AppErrorBoundary](../../../web/src/components/common/AppErrorBoundary.tsx) outside the router with inline styles + hardcoded bilingual strings — immune to i18n/Tailwind/router failures.
- `lazyWithRetry` handles the deploy-mid-session case: a chunk 404 triggers ONE auto-reload per tab (`sessionStorage` flag, try/catch-guarded for lockdown webviews) which also picks up the waiting service worker; a second failure throws to the boundary.
## 🔌 Real error flows wired in
- [QueryState.tsx](../../../web/src/components/common/QueryState.tsx) `ErrorState` upgraded in place (contract preserved): offline detection swaps in the `errors.offline.*` copy + `WifiOff` icon, plus Retry / Report-issue action buttons. All 17 call sites now pass `onRetry={() => void q.refetch()}`.
- Expired/revoked token on session restore ([stores/auth.ts](../../../web/src/stores/auth.ts) `hydrate()` catch) now fires a Sonner toast with the shared `errors.419.*` copy and an "Open Settings" action (10 s duration — the 4 s default is too short for action toasts). Deliberately a toast, not a redirect: don't hijack whatever page the user opened. Auth gating on `/add` stays as-is.
## 🖼️ Images
- `decoding="async"` added to every `<img>` (10 sites: table thumbs, mobile cards, command palette, detail drawer, avatars, About QRs) — keeps image decode off the main thread during virtualised scrolling.
- Detail drawer header image now goes through a new `preferWebp()` ([web/src/lib/image.ts](../../../web/src/lib/image.ts)): weserv WebP transcode (~50 KB → ~20 KB) on web, **direct Steam URL on Tauri desktop** (no third-party calls from the bundled app), with an `onError` fallback to the original. Replaces the old `<picture><source>` markup, which only falls back on unsupported *type* — a weserv outage would have shown a broken image. Thumbnails intentionally stay on direct Steam capsules (~10 KB, SW-cached); `webpProxyUrl` is no longer exported.
## ⌨️ Search responsiveness
- [GamesTable.tsx](../../../web/src/components/games/GamesTable.tsx): the Fuse.js search input is wrapped in `useDeferredValue` — typing stays per-keystroke responsive while filtering ~1.2k records lags at React's low priority. No debounce timer (deferral only delays when the machine is actually busy). Same treatment + `useMemo` for the command palette's game scan.
## 🧰 Tooling & misc
- `rollup-plugin-visualizer` devDependency + `npm run analyze` (`vite build --mode analyze` → `dist/stats.html` treemap, gzip/brotli sizes).
- [index.html](../../../web/index.html): `preconnect` hints for `raw.githubusercontent.com` (shard fetches, crossorigin) and `shared.akamai.steamstatic.com` (thumbnails).
- `npm audit fix` — react-router open-redirect advisory GHSA-2j2x-hqr9-3h42 (`react-router-dom` 6.30.x patch line); `npm audit` and `pip-audit` both report 0 known vulnerabilities.
+26
View File
@@ -0,0 +1,26 @@
# v3.4.0 – 2026-06-13 (The "Legal Consent Gate" Edition)
[All versions](../../../CHANGELOG.md)
Feature release on top of v3.3.0 adding an explicit, up-front acceptance of the project's legal documents on both surfaces: a first-run consent gate in the app (web + desktop) and a real license-agreement page in the Windows installer. No backend, no cookies — acceptance is a single `localStorage` flag, versioned so it can re-prompt when the terms change, and naturally fresh in incognito/private tabs. Web app + desktop bumped `1.3.0` → `1.4.0`. Repo public-facing version `3.3.0` → `3.4.0`. Tag `v3.4.0` is GPG-signed; companion desktop tag is `desktop-v1.4.0`.
## ⚖️ First-run consent gate (web + desktop)
- New [ConsentGate.tsx](../../../web/src/components/common/ConsentGate.tsx) — a full-screen card (styled like the error pages, eager bundle, no flash) that blocks the main UI until the user ticks a checkbox and clicks **Continue**. Mounted inside `AppErrorBoundary` + `HashRouter` in [main.tsx](../../../web/src/main.tsx), wrapping `<App/>` (the `<Toaster/>` stays a sibling). A gate crash is still caught by the top-level boundary.
- **Decline path** — explicit **Decline** button: on desktop (Tauri) it quits the app via `getCurrentWindow().close()`; on web it shows a blocking "you need to accept" notice with a way back to the gate.
- **Persistence** — new [stores/consent.ts](../../../web/src/stores/consent.ts) (Zustand, same pattern as `stores/gpg.ts`): `localStorage` key `f2p:legal_consent` holding `{ version, acceptedAt }`. A `TERMS_VERSION` constant gates validity — bump it when the legal docs change materially and everyone is re-prompted. Incognito tabs get a fresh storage partition, so the gate re-shows there with zero extra code. No cookie is used anywhere (there is no server to read one).
- **Error routes pass through** — the gate lets `#/error/*` render even before consent, so a mid-session chunk-load 503, the Pages `404.html` redirect, or an `#/error/:code` deep link still reaches the user instead of being swallowed.
- **Doc links** — the gate's five binding documents (MIT License, EULA, Privacy Policy, Disclaimer, Terms of Use) open through the existing [external-open.ts](../../../web/src/lib/external-open.ts) `openExternal()` helper, so they work inside the Tauri webview (which blocks `window.open` to external HTTPS) as well as on the web.
- **Shared legal list** — the `LEGAL_DOCS` array (label / path / hint) was lifted out of [About.tsx](../../../web/src/pages/About.tsx) into a reusable [lib/legal.ts](../../../web/src/lib/legal.ts) (`LEGAL_DOCS`, `CONSENT_DOCS`, `legalDocUrl()`); About now imports it instead of holding a private copy.
- New `consent.*` i18n keys added to both [en.json](../../../web/src/i18n/locales/en.json) and [vi.json](../../../web/src/i18n/locales/vi.json). Long-form legal copy stays English (the doc labels come from `LEGAL_DOCS`); only the gate chrome is bilingual.
## 🪟 Windows installer license page
- [tauri.conf.json](../../../web/src-tauri/tauri.conf.json) now sets `bundle.licenseFile` to a new [LICENSE_AGREEMENT.rtf](../../../web/src-tauri/LICENSE_AGREEMENT.rtf). Tauri v2 surfaces this as a mandatory "I Agree" license page in **both** Windows targets built by `targets: "all"` — the NSIS `-setup.exe` (MUI license page) and the WiX `.msi` (which requires RTF). The RTF is plain ASCII with no BOM to avoid the known NSIS license-encoding bug.
- The installer gate (install-time, desktop-only) and the in-app gate (first-run, web + desktop, re-promptable) are intentionally both kept: the auto-updater replaces the binary without re-running the installer, so the in-app `TERMS_VERSION` mechanism is the only way to re-prompt updated installs.
- Desktop window-close on decline needs the `core:window:allow-close` permission, now added to [capabilities/default.json](../../../web/src-tauri/capabilities/default.json). New dependency `@tauri-apps/api` (official, lazy-imported only on the desktop decline path — no web-bundle bloat).
## 🧰 Tooling & misc
- Version bumped across the three desktop files ([web/package.json](../../../web/package.json), [tauri.conf.json](../../../web/src-tauri/tauri.conf.json), [Cargo.toml](../../../web/src-tauri/Cargo.toml)) → `1.4.0`; the stale README version badge corrected `3.2.7` → `3.4.0`.
- Pre-publish suite (`typecheck`, `knip`, `npm audit`, `vulture`, `pip-audit`) re-run clean.
+14
View File
@@ -0,0 +1,14 @@
# v3.4.1 – 2026-06-14 (The "Chart Hotfix" Edition)
[All versions](../../../CHANGELOG.md)
Patch release fixing a production regression introduced by the Vite 8 / Rolldown deploy hotfix (#95): every chart tab threw a blank **React error #130** and failed to render. Web app + desktop bumped `1.4.0` → `1.4.1`; repo public-facing version `3.4.0` → `3.4.1`.
## 🐛 Charts render again (React #130)
- [EChart.tsx](../../../web/src/components/charts/EChart.tsx) imported the chart wrapper from `echarts-for-react/lib/core` — the **CommonJS** build. Under Vite 8's Rolldown bundler the CJS default-interop wraps `module.exports = class` into a namespace object, so `<ReactEChartsCore/>` received an object instead of a component → React error #130 on **every** chart page (all [pages/charts/*](../../../web/src/pages/charts) + the [Dashboard](../../../web/src/pages/Dashboard.tsx)). Switched the import to the **ESM** build `echarts-for-react/esm/core`, which has a clean `export default`. echarts core and echarts-wordcloud were already ESM, so this single import was the only offender.
- Verified at **runtime against the production (Rolldown) build** (the step skipped in #95): bar, pie/donut, line, treemap, heatmap and wordcloud charts all render with zero console errors. `echarts`/`openpgp` remain lazy async chunks (not eager-preloaded in `index.html`).
## ⚠️ glib advisory (Linux desktop) — acknowledged, no upstream fix
- The Dependabot alert for the `glib` crate ([GHSA-wrw7-89jp-8q8g](https://github.com/advisories/GHSA-wrw7-89jp-8q8g), medium, Linux-only) cannot be resolved within Tauri 2.x: the latest `webkit2gtk` crate (2.0.2) pins `glib ^0.18`, `tao`/`wry` pin `gtk ^0.18`, and Tauri 3 is not released. Only the Linux build links glib (Windows = WebView2, macOS = Cocoa) and the app does not call the affected API, so the alert is dismissed as tolerable risk. Will revisit when the upstream stack adopts gtk-rs 0.20. See [TAURI.md](../../../web/src-tauri/TAURI.md).
+23
View File
@@ -0,0 +1,23 @@
# v3.4.2 – 2026-06-15 (The "Android Floor" Edition)
[All versions](../../../CHANGELOG.md)
Android-focused release that raises the APK's minimum OS, hides a desktop-only
affordance on phones, and documents the support policy with sourced numbers. Web
app + desktop/Android bumped `1.4.3` → `1.4.4`; repo public-facing version
`3.4.1` → `3.4.2`. Tag `v3.4.2` is GPG-signed; the Android APK ships from
`android-v1.4.4`.
## 🤖 Minimum Android raised to 11 (API 30)
- [build.gradle.kts](../../../web/src-tauri/gen/android/app/build.gradle.kts) `minSdk` `24` → `30`. Android's package installer refuses to install the APK below this (`INSTALL_FAILED_OLDER_SDK`), so the version floor doubles as the OS-level install gate — no in-app check, no bypass. Don't re-run `tauri android init` (it would reset it).
- **Why 11, not lower:** Android 7–10 are deeply end-of-life — Google ships OS security backports only for 14/15/16 as of mid-2026 — and tend to carry an outdated System WebView that breaks the modern ES2022 / React 19 output of the Vite 8 / Rolldown bundle. A `minSdk 30` floor still reaches ~87% of active Android devices (StatCounter, May 2026) while dropping only the dead tail. Android 11–13 install but no longer get Google OS patches — called out explicitly in the docs.
## 📱 "Steam Desktop" button hidden on mobile
- The `steam://` "Steam Desktop" button in [GameDetailDrawer.tsx](../../../web/src/components/games/GameDetailDrawer.tsx) can't reach a Steam client on a phone, so it's now hidden on the Android app **or** a sub-768px viewport; the "Web" button stays. Gated by a new reactive [useIsMobile.ts](../../../web/src/hooks/useIsMobile.ts) hook (`useSyncExternalStore` + `matchMedia("(max-width: 767px)")`, OR the existing `isAndroid()` from [external-open.ts](../../../web/src/lib/external-open.ts)) — re-renders on resize / rotation. No new i18n strings.
## 📚 Docs & transparency
- New [docs/android-support.md](../../../docs/android-support.md) (+ Vietnamese mirror [i18n/vi/android-support.md](../../../docs/i18n/vi/android-support.md)): minimum requirement, full rationale (security/EOL, WebView/React compatibility, edge-to-edge), tested-device matrix (emulator Android 11→16, real **vivo 1907** on Android 12), and a worldwide version-share + security-EOL table with **cited sources** ([apilevels.com](https://apilevels.com/), [StatCounter](https://gs.statcounter.com/android-version-market-share/mobile/worldwide/), [endoflife.date](https://endoflife.date/android), [Android Security Bulletins](https://source.android.com/docs/security/bulletin)). Reused as the GitHub Discussion announcement.
- Updated [TAURI.md](../../../web/src-tauri/TAURI.md), [pc_spec.md](../../../docs/pc_spec.md) (+ VN mirror) with the new Android test-device section, the [release-android.yml](../../../.github/workflows/release-android.yml) release-notes template, and the [README](../../../README.md) (version badge `3.4.1`→`3.4.2`, new Android 11+ badge + Quick-links row).
+51
View File
@@ -0,0 +1,51 @@
# v3.4.3 – 2026-09-11 (The "Own Domain" Edition)
[All versions](../../../CHANGELOG.md)
The site moved off GitHub Pages to **free-steam-games.win** on Cloudflare, and
the catalogue gained a reviewed intake path for new games plus durable manual
corrections. Web app + desktop/Android bumped `1.4.4` → `1.4.5`; repo
public-facing version `3.4.2` → `3.4.3`. Tags `v3.4.3`, `desktop-v1.4.5` and
`android-v1.4.5` are GPG-signed; both binary workflows publish **draft**
releases.
## 🌐 New home
- Served by a Cloudflare Worker with static assets; data is proxied same-origin
at `/api/data/*`, Steam art at `/img/*`. Details: [docs/DEPLOYMENT.md](../../../docs/DEPLOYMENT.md).
- Real URLs on the web (`/games/730`) instead of `/#/games/730`; old hash links
are upgraded on load. The desktop/Android shell keeps hash routing.
- Content-Security-Policy and hardening headers, with a check command for every
setting in [docs/SECURITY_SETUP.md](../../../docs/SECURITY_SETUP.md).
## 📥 New games: discovered, then reviewed
- `Discover New Games` sweeps the Steam store daily into a review queue; the
maintainer approves at `/admin` (behind Cloudflare Access). Approval queues
the game for `ingest_new.py`, and a reconcile cron confirms it landed.
- Submissions from outside now come only through the
[browser extension](https://github.com/poli0981/steam-f2p-extension); the
issue-template and Telegram-bot paths were removed.
## ✏️ Corrections that survive the pipeline
- Manual fixes (genre, notes, anti-cheat…) live in
`data/overrides/<appid>.json` and are re-applied on every write, so a refetch
or genre normalisation can no longer revert them. Edit from `/admin/edit`
(single game or bulk by genre) or `scripts/edit_game.py`.
## 📄 Data & licensing
- Dataset licensed separately under CC BY 4.0 ([LICENSE-DATA](../../../LICENSE-DATA));
code stays MIT. Terms updated, so the consent prompt appears once more.
- `description` is now a short quotation — capped at 180 characters and
attributed in the app.
- The bulk markdown tables in `games/` were removed; the two leaderboards stay.
## 🖥️ Desktop & Android
- Packaged apps now read from free-steam-games.win; the Worker sends CORS for
`/api/data/*` so they can. Builds made from `main` before this fix could not
load the catalogue — no released build was affected.
- The Tauri webview has a real CSP (`ipc:` included, so native calls keep
working). **Smoke-test the draft builds before publishing.**
+208
View File
@@ -0,0 +1,208 @@
# v4.0.0 – 2026-09-17 (The "Rewrite" Edition)
[All versions](../../../CHANGELOG.md)
The end-user web app was rewritten from React 19 to **SvelteKit 2 / Svelte 5**,
given a typeface and a palette of its own, and gained the pages it had been
missing. `/admin` was rebuilt as an app of its own, embedded in the Worker. The
data path now verifies every shard it caches, every game has a page search
engines can read, the web app is installable, and the desktop app updates
itself. Web app + desktop/Android bumped `1.4.5` → `2.0.0`; repo public-facing
version `3.4.3` → `4.0.0`.
Breaking for anyone who packaged or embedded the old build: the desktop window
is now resizable, the `tauri-plugin-http` native bridge is gone, and the
Content-Security-Policy is emitted by the app itself rather than by
`_headers`.
Deploying it needs one manual step: `npx wrangler d1 migrations apply f2p-admin
--remote` (migration `0002_admin_state.sql`). The Worker runs without it,
degraded, and `/admin/health` says so.
## 🎨 A front end that looks like something
- **Rewritten on SvelteKit 2 + Svelte 5 runes.** 30 routes, prerendered to
static HTML — every page now ships real markup to a crawler instead of an
empty shell. React, react-router, zustand, TanStack Query, cmdk and Radix
are gone; Bits UI, `@tanstack/svelte-virtual` and svelte-sonner replace
them.
- **Three self-hosted typefaces**, subsetted to Latin, Latin-Ext and
Vietnamese: Bricolage Grotesque for display, IBM Plex Sans for body and the
3,666-row table, JetBrains Mono for figures. The old build declared `Inter`
and shipped no font file at all, so it had always rendered in `system-ui`.
- **A warm amber palette**, replacing the Tailwind 3 defaults the previous
version kept "until the palette rework", plus a skip link, a
`:focus-visible` rule and a `prefers-reduced-motion` block — none of which
had ever existed.
- **A brand mark that is geometry, not a font glyph.** The old icon drew "▶"
as SVG `<text>` in `system-ui`: a different shape on every platform, and
tofu where no font supplied it.
## 📄 New pages
- `/legal/:doc` — all eight documents, rendered from the repo's markdown **at
build time**, so no markdown parser or sanitiser reaches the browser. The
welcome screen used to intercept these links and redirect to `/about`.
- `/games/:appid` — a real page per game, **prerendered for all ~3,600 games**
from build-time seeds with `VideoGame` structured data, and listed in the
sitemap. Player counts and reviews still come live from the catalogue.
- `/welcome` — a first-run introduction, shown once after the terms are
accepted: what the list is and is not, three ways in, the language, and the
documents just accepted.
- `/legal` — an index of the documents. An unknown document is a translated
404 rather than the dashboard.
- `/developers`, `/developers/:name`, `/publishers/:name` — `developer[]` and
`publisher[]` were on every record and used by nothing.
- `/stats` — the fields no chart covered: Metacritic distribution, peak-vs-now
retention, safety flags, language coverage, review-label buckets, and when
games went quiet.
- `/charts/time` gains catalogue growth (added per month, running total), and
the anti-cheat index is a searchable, sortable table.
## 🔎 Findable
- **Open Graph and Twitter cards on every page.** There were none, so a shared
link rendered as a bare grey URL everywhere. `og:image` is a real 1200×630
PNG — it used to point at an SVG, which no social platform renders.
- **Canonical URLs on every page**, not just `/games/:appid`.
- **`sitemap.xml` generated from the route table.** The old one listed four
URLs, three of them pointing at github.com, and none of the app's own routes.
- PNG icons for the PWA manifest and `apple-touch-icon`, which never accepted
SVG.
## 🛠️ `/admin` rebuilt
- **Its own app.** The two Worker-rendered pages (1,400 lines of HTML and
script inside template literals) are replaced by a Svelte 5 app in
`web/admin/`, embedded in the Worker and served only behind Cloudflare
Access, with a nonce-only script policy. None of it reaches `dist/`, the
service worker or the packaged apps, and the build fails if any does.
- **Decided rows are read-only.** Approved, committed and rejected rows, and
undecided rows for a game that is already published, have no checkbox and
are skipped by select-all. The server enforces the same rules from one shared
module, and every row a decision cannot touch comes back with a reason
instead of being dropped silently.
- **Reopen** a rejected row from its details, with the reason when it cannot be.
- Every decision is confirmed first; tabs, search, sort and page live in the
URL; keyboard shortcuts; a phone layout.
- **Corrections** are reviewed as a diff before the commit, bulk changes can set
or retire any field across pages, and a settled override file can be deleted.
- **Jobs, Audit and Health** have their own pages. Health still draws its table
when the answer is a 503, and Test write proves the write path.
- Deferring or requeueing a failed row next to an open one no longer 500s; an
approval whose commit landed but whose queue update failed says exactly that
and leaves its job marked committed.
- **Reconcile** holds a D1 lease, sweeps undecided rows whose game appeared in
`data/` by another route, and skips the dataset fetch while nothing changed.
- `audit_log` and `commit_jobs` are pruned after 180 days, as the privacy
policy now says.
- `npm run dev:admin` runs the real handlers against an in-memory database, so
the admin can be worked on without deploying it.
## 🧮 Data you can trust
- `data/index.json` carries a **SHA-256 per shard**, and `last_updated` changes
only when the data did — a pipeline run that changed nothing no longer makes
every visitor re-download ~6 MB.
- The Worker serves `?v=<sha256>` shard requests content-addressed and
immutable, and refuses (503) while GitHub's CDN still has the previous bytes.
- The app caches only a generation whose hashes verified, keeps the last good
one for offline use, and re-checks when the tab comes back. A long-lived tab
used to show a count and date days out of date.
## 📲 Installable, and updatable
- The web app registers its service worker (it never had, on the SvelteKit
build), offers installation, works offline, and asks before reloading into an
update.
- The **desktop app updates itself**: it checks a feed at
`/api/updates/desktop`, which offers only a published `desktop-v*` release,
shows the notes, and restarts into the new version. The old endpoint pointed
at the repository's "latest" release, usually a dataset release, and 404'd.
- Updating no longer wipes settings: the webview is cleared once, only when
coming from a build older than 2.0.
- `steam://` links open the Steam client from the apps.
## 🔐 Security
- **A negative `limit` disabled the SQL bound.** `Math.min(Number("-1") || 50,
200)` is `-1`, and SQLite treats a negative LIMIT as unlimited — so
`?limit=-1` dumped the entire never-pruned audit log. Clamped.
- **A token with a missing or non-numeric `exp` never expired.** `exp` is now
required and numeric.
- **The JWT is no longer accepted from a cookie on writes.** Only the
`Cf-Access-Jwt-Assertion` header, which browsers never send cross-site.
- A signing-key rotation locked out admin and ingest for up to an hour as an
opaque 404; the JWKS is refetched once on an unknown `kid`, and a fetch
failure is now a 503 rather than "not found".
- Every server crash was reported to the reviewer as "Session expired" — the
admin pages sniff Content-Type, and an unhandled throw became Cloudflare's
HTML 1101 page. There is a top-level handler now.
- A reject can no longer downgrade an approved game, which would have made it
permanently invisible to every future discovery sweep.
- `header_image` is validated as an HTTPS Steam CDN URL, not merely
length-capped.
## ✅ Tests, where there were none
`docs/ADMIN.md` claimed the override byte-parity between `scripts/edit_game.py`
and the Worker was "asserted by a parity test". No test existed anywhere in the
repo. Vitest now covers the app, the Worker (against a real SQLite database with
the real migrations) and the admin app; pytest covers the index hashing; cargo
covers the upgrade purge. The first 95 were each checked by mutation, not
merely by passing. `verify-dist.mjs` reads the built HTML in CI for the
mistakes that only exist there.
## 🖥️ Binary 2.0.0
- **The window unlocks.** It was pinned to exactly 1400×900, non-resizable and
non-maximisable, which made a responsive redesign pointless on the one
platform that could not use it. Now 1280×860, resizable, minimum 880×600.
- **`tauri-plugin-http` removed** along with its `https://github.com/*`
capability. It existed for the GitHub OAuth Device Flow, which went with
sign-in; the only remaining GitHub call is the Android release check, which
is a plain `fetch` to an endpoint that sends CORS headers.
- Real paths, no hash router. `tauri::manager::get_asset()` resolves
`/games/730` through its own fallback chain; the note claiming the webview
had no server-side fallback was out of date. Links from released 1.4.x
builds are still upgraded on load.
## 🐛 Fixed on the live site
- Raw placeholders on screen: `Languages ({{count}})`, `(PEAK {{PEAK}})` as a
field label, `(peak {{peak}})` on a chart axis, and one in a prerendered meta
description. A test now reads every call site.
- Hovering a chart tile, bar or slice blanked it (the colour format zrender
cannot parse), the genre treemap tooltip printed `({d}%)`, and axis names
were clipped on `/stats`.
- The command palette crashed on open (a duplicate route), the consent overlay
covered the documents it asked people to read, unknown URLs rendered the
dashboard, and old `/#/` links changed the address bar without the page.
- Vietnamese readers saw English for the legal document names, the table's
data-issue hints and the About page's stack. 137 locale keys nothing used any
more are gone, and a test fails on the next one.
- The report-only CSP messages in the console come from Cloudflare's
Continuous script monitoring, not the site; `docs/SECURITY_SETUP.md` says how
to turn it off.
## 🐛 Console
Every reported error is fixed, and each was measured rather than assumed:
- GitHub avatars were blocked by CSP on `/activity`. They are proxied through
the Worker at `/img/gh/*`, so `img-src` stays `'self'`.
- The Cloudflare Access re-auth fetch was blocked. It uses a full-page
redirect now.
- `[Violation] 'setTimeout' handler took 122ms` — zero long tasks while four
charts initialise, because each waits for an IntersectionObserver instead of
all of them racing in one frame.
- `[Violation] non-passive 'mousewheel' listener` — zrender binds both `wheel`
and `mousewheel` with no options object, unconditionally. Four blocking
listeners for two charts, measured; now zero.
## 📇 Contact
The maintainer address is **contact@poli0981.dev**; every other channel is
`https://poli0981.dev/links/`. `CODE_OF_CONDUCT.md` had no reporting address at
all. `/.well-known/security.txt` exists and is served as `text/plain` — it used
to return the app shell with HTTP 200.
+133
View File
@@ -0,0 +1,133 @@
# v4.0.1 – 2026-09-23 (The "Human Check" Edition)
[All versions](../../../CHANGELOG.md)
The web app now asks each browser to pass a Cloudflare Turnstile check once a
day after the terms are accepted, shows a changed legal document as a diff
instead of asking for a full re-read, and counts page views with Cloudflare
Web Analytics. The desktop app's game artwork - blank because its webview
sends a Referer the zone's Hotlink Protection refuses - is back, and nothing in
the app loads data before the reader is past the consent step and the check. Web app + desktop/Android
bumped `2.0.0` → `2.0.1`; repo public-facing version `4.0.0` → `4.0.1`.
The web changes are already live - pushing `main` deploys. The desktop app
offers 2.0.1 through its updater once the release is published; on Android,
install the new APK over the old one. Returning visitors see the consent gate
once, listing only the Privacy Policy and Terms of Use changes.
## ✨ Added
- **A legal document that changes now shows you the change, not the whole
document again.** Each binding document is hashed at build time
(`virtual:legal-versions`); when one differs from the version you accepted,
the consent gate reopens on its own and lists only that document, with a
`+`/`-` diff against the copy kept in your browser. `TERMS_VERSION` is no
longer the only signal — it stays as the lever that forces a full re-read.
Clearing site data removes the stored copy, and the gate then links to the
full text instead.
- **Cloudflare Web Analytics**, cookieless, loaded only after you accept the
terms and never in the desktop or Android apps. It replaces an "automatic"
edge injection that had been enabled for months and could never have worked:
it inserts an inline script, and a hash-based CSP ignores `'unsafe-inline'`
by specification, so it only ever produced two console errors per page load.
Measured on the live site: the beacon returns 200 and its reports 204, with
nothing loaded at all before consent.
- **A human-verification step for suspicious page loads, and a country block**
(mainland China, Russia, Argentina). Both are WAF custom rules, live since
2026-09-20 and documented with their expressions and every exclusion in
`docs/SECURITY_SETUP.md`. Verified after they went live: a plain `curl` with
no browser User-Agent is still served every public path, and the challenge
rate has stayed at 0%. `BLOCKED_COUNTRIES` in `wrangler.jsonc` makes the
Worker refuse the same countries as defence in depth; the rule is the
boundary, because prerendered pages never reach the Worker at all.
- **A Cloudflare Turnstile check on the website**, separate from the WAF
challenge above: after accepting the terms, each browser passes a Turnstile
widget at most once every 24 hours before the app loads its data. The Worker
verifies the token at `POST /api/human-check` with the `TURNSTILE_SECRET`
secret, checking the action and the hostname; nothing is stored server-side.
It is an overlay like the consent gate, so prerendered pages and crawlers are
unaffected, and it is soft on purpose: `/api/data/*`, `/img/*` and the
desktop and Android apps never require it (the Terms of Use promise as much).
It refuses only when Cloudflare says no; a missing secret, a siteverify
outage, a widget misconfiguration or being offline let the reader through for
that page load. The web CSP gains `challenges.cloudflare.com` in `script-src`
and a new `frame-src`; `verify-dist.mjs` fails the Tauri build if either
appears there. The privacy policy and the terms describe it, so returning
visitors see those two documents' changes at the consent gate once.
## 🐛 Fixed
- **Game artwork was blank in the desktop app** (and would be on Android): the
WebView2 webview sends `Referer: http://tauri.localhost/`, and the zone's
Hotlink Protection refused every `/img/*` request carrying it — before the
Worker ran, so nothing in the app's logs showed it. Every `<img>` now sets
`referrerpolicy="no-referrer"`, which the protection allows, and
`src/lib/images.test.ts` fails on one that does not. That also fixes the
thumbnails `npm run dev` could never show. Installed 2.0.0 apps are covered
by a Configuration Rule on the zone until they update; Hotlink Protection
itself stays on for other sites.
- **`/activity` and `/charts/delisted` fetched their data before consent.** The
root layout held the catalogue back, but those two pages called `load()`
from effects of their own, and the activity feed also refetched on window
focus. The gate now lives in `Resource` itself: an `enabled` option read
inside every `load()`, which every resource sets to `appReady()` - consent
accepted and the human check cleared - so a held-back load starts by itself
once both are passed. `src/lib/resource.test.ts` fails on a `new Resource`
without it.
- **The service worker threw `non-precached-url: /200.html` on every page
load.** `navigateFallback` named the adapter-static fallback, which is
written into `dist/` after workbox has already globbed the build output — so
it was never in the precache, and the throw abandoned the rest of the
worker's setup. It is now `/`, which is both precached and what Cloudflare
and Tauri already serve for an unmatched path. `verify-dist.mjs` fails the
build if the two ever disagree again.
- **`/admin` no longer writes the maintainer's email address into public Git.**
Commit bodies and `data/overrides/*.json` say `admin`; the four override
files that already carried it were rewritten. The acting identity is still
recorded in D1, where `/admin/audit` reads it.
- **`/admin` said "Your Cloudflare Access session has expired" straight after
signing in, in a private window too.** Its API was at `/api/admin/*`, behind
a second Cloudflare Access application. Access issues its session cookie per
application and `fetch()` cannot follow the sign-in redirect, so the session
for `/admin` never reached the API and every call bounced to the login page.
The API now lives at `/admin/api/*`, under the page's own application, and
`worker/index.test.ts` drives it through the real router and token check.
The `/api/admin` Access application is no longer used and can be deleted.
- `scripts/discover_new.py` took any host ending in `cloudflareaccess.com` for
an Access login page, lookalikes included; the suffix check now needs the dot.
- The i18n, SEO and chart tests share one comment stripper instead of three
regexes, one of which removed text that was never inside a comment.
## 📚 Docs
- `docs/ACKNOWLEDGEMENTs.md` listed the dependencies of the **React** app —
React 18, react-router, i18next, Zustand, TanStack Query, Radix, shadcn/ui,
OpenPGP.js, Tailwind 3, TypeScript 5, PostCSS. None of that has shipped since
the v4 rewrite. Replaced with the real list, licences checked against
`node_modules` rather than remembered (`echarts-wordcloud` is ISC, not
BSD-3-Clause), and the claim that `/about` carries a "full SPDX list" dropped
— it is a curated subset.
- `docs/DEPLOYMENT.md` records that a zero-duration "Workers Builds" failure on
a PR branch is a preview-build artefact, not a broken commit, so the next
person does not go looking for a bug that is not there.
- `docs/SECURITY_SETUP.md` section 10 claimed the packaged apps survived Hotlink
Protection because their webview sent no Referer, recommended switching the
protection off, and said no allowlist could express the apps' origin. The
first was no longer true and the last never was; it now documents the
per-image fix and the Configuration Rule, with the measured check. A new
section 12 covers the Turnstile widget settings, the secret and local testing
with Cloudflare's test keys (`web/.dev.vars.example`).
- Stale `public/_headers` paths (the file has been `static/_headers` since the
SvelteKit move) and a `SITE_ORIGIN` that is really `API_ORIGIN` in
`src/lib/site.ts` are corrected in `worker/lib/http.ts`, `svelte.config.js`
and the security doc; `_headers` itself gains comments on why images opt out
of its Referrer-Policy.
## 🛠 CI
- The Android release builds the tag it releases (a manual run used to build
`main`), installs `platform-tools` only (the SDK no longer carries `tools`,
which stopped `android-v2.0.0`), and names the commit it built.
- CodeQL also runs when only `.mjs`/`.cjs` files change, and
`verify-dist.mjs` finds `<script>`/`<style>` by scanning.
+56
View File
@@ -0,0 +1,56 @@
# v4.0.2 – 2026-09-29 (The "Right Address" Edition)
[All versions](../../../CHANGELOG.md)
A game's tags, languages and store details are now re-read on a rotation
instead of being fetched once and never again, a long data job no longer loses
its work when something else lands on `main`, and each kind of message now has
an address of its own. Web app + desktop/Android bumped `2.0.1` → `2.0.2`; repo
public-facing version `4.0.1` → `4.0.2`.
The web changes are live as soon as this merges. The desktop app offers 2.0.2
through its updater once the release is published; on Android, install the new
APK over the old one. Returning visitors see the consent gate once, listing
the Privacy Policy, the Terms of Use and the Data Licence — each changed only
by a contact address, and the gate shows exactly that line.
## ✨ Added
- **Tags, languages and the rest of a game's store data now stay current.**
`update_data.py` only fills in incomplete records, and only empty fields, so
once a game had its tags, languages, platforms or header image nothing looked
at them again short of a manual full re-fetch. `Refresh Store Data` (daily,
16:00 UTC) re-reads them on a rotation: the store page - tags, languages and
their details, the paid-DLC flag - for every game once a week, and
appdetails - name, header image, description, developer and publisher,
release date, platforms, Metacritic, DRM notes - once a month. About 630
store pages and 150 appdetails calls a day instead of 8,800 requests in one
sitting. It never blanks a value on a failed or age-gated page, never
touches the hand-set fields (genre, type, anti-cheat, safety, notes), and
marks a game updated only when something changed. A dry run on three games
found all three with tags that had drifted since they were first fetched.
## 🐛 Fixed
- **A long data job lost its work if anything landed on `main` meanwhile.**
`purge-unhealthy` ran for four hours on 2026-09-21 and then failed on
`push rejected (fetch first)`: the data-write group serialises workflows,
but a merged pull request or an `/admin` commit still moves `main`. Every
data job now commits through `bash/commit_push.sh`, which rebases onto
`origin/main` and retries the push.
## 📇 Contact
`contact@poli0981.dev` stays the default. Three role addresses join it, each
published where a reader of that document would look:
| Address | For | Where |
|---|---|---|
| `security@poli0981.dev` | vulnerabilities, after GitHub's private reporting | `SECURITY.md`, `/.well-known/security.txt` |
| `privacy@poli0981.dev` | privacy questions | Privacy Policy |
| `copyright@poli0981.dev` | copyright, DMCA and takedown notices | Data Licence, Terms of Use §6 |
The maintainer's website, <https://poli0981.dev/>, is on the About page next
to the email and the links page. `security.txt` now lists GitHub's private
vulnerability reporting first and `security@` second, in RFC 9116 preference
order. The full map is in `AUTHORS.md` and `docs/Contact.md`.
+67
View File
@@ -0,0 +1,67 @@
# v4.1.0 – 2026-10-02 (The "Featherweight" Edition)
[All versions](../../../CHANGELOG.md)
Game art and the catalogue both got much lighter, the deploy log lost its
noise, and scrollbars finally look like the rest of the site. Web app +
desktop/Android bumped `2.0.2` → `2.1.0`; repo public-facing version `4.0.2` →
`4.1.0`.
The web changes are already live. The desktop app offers 2.1.0 through its
updater once the release is published, and brings the packed catalogue with
it; on Android, install the new APK over the old one. Returning visitors see
the consent gate once, showing one new line in the Privacy Policy: the storage
key of the new scrollbar setting.
## ✨ Added
- **Game art is AVIF now - heroes about 58% smaller, thumbnails about 92%.**
The Worker's 15-minute cron encodes each game's Steam header once with
Cloudflare Images - a 230 px thumbnail and a 460 px hero - and stores it in
R2; every request after that is served from the stored copy, never encoded
on the fly. The ten most-played heroes went from 40 KB to 16.8 KB (SSIM
0.979 against Steam's JPEG); thumbnails are ~3.4 KB. Most-played games go
first, the whole catalogue takes about a day and a half, and a hard monthly
cap keeps the Images bill bounded. Browsers that do not take AVIF keep
getting Steam's JPEG, and social cards always do.
- **The catalogue downloads in about a seventh of the bytes.** The app now
reads each shard as a packed file (`/api/data/p1/*.bin`, 224 KB instead of
1.5 MB): compressed, and wrapped so the site's API is no longer a
ready-made JSON feed. It is obfuscation, not secrecy - the readable dataset
is the repository, as it always was. The app checks what it unpacks against
`index.json` exactly as before, and the released apps keep reading the
plain files.
- **Scrollbars match the site, and can be hidden.** A warm thumb that turns
amber under the pointer, in both themes. Settings → Scrollbars: Visible,
Hidden in tables and panels, or Hidden everywhere; hidden bars still scroll
with the wheel, trackpad, touch or keyboard.
## 🐛 Fixed
- **Every deploy log was 91% noise.** The build printed one
`[404] GET /img/…` per prerendered game - 5,566 lines - and rendered an
error page for each. They were harmless (a Worker route the build cannot
see), but they buried anything worth reading. Now there are none.
- **The plain catalogue went out uncompressed.** Cloudflare does not compress
`application/x-ndjson` by default, so every full load moved ~9 MiB. A
Compression Rule now brotli-compresses those files for every client,
released apps included (1.5 MB → 226 KB per shard).
- **Tables showed the operating system's grey scrollbar.** Tailwind 4.3's own
`scrollbar-thin` merged with ours and, in Chromium, switched the themed bar
off. Ours is now `scrollbar-slim`, with a test that keeps it that way.
- **Thumbnails cost two guaranteed 404s on half the catalogue**, probing for a
Steam capsule that hashed paths never have, and stray query strings forked
the image edge cache.
- **A data-only commit redeployed the whole site** (5,681 files), against
what `docs/DEPLOYMENT.md` intends. The fix is the Workers Builds watch
paths, a dashboard setting.
## 🔐 Security
- **`/img/*` can no longer be used to run up the image bill.** With
Cloudflare's URL transformations enabled, `/cdn-cgi/image/<options>/img/…`
let anyone bill a new transformation per option set, through a proxy that
serves any Steam game's art - a scanner found such a URL within minutes. The
Worker now refuses the transformation service as a client, and URL
transformations are switched off for the zone; the cron's encoding does not
need them.
+75
View File
@@ -0,0 +1,75 @@
# v4.1.1 – 2026-10-03 (The "Pocket-Sized" Edition)
[All versions](../../../CHANGELOG.md)
The site and the apps fit a phone: nothing runs off the right edge, game
names are back in the leaderboards, and the Android app no longer puts its
top bar under the clock. Web app + desktop/Android bumped `2.1.0` →
`2.1.1`; repo public-facing version `4.1.0` → `4.1.1`.
On the website the phone fixes go live with this release; the caching
changes below already were. The desktop app offers 2.1.1 through its updater
once the release is published; on Android, install the new APK over the old
one. The apps also pick up the Privacy Policy line about the image host
below, so they show the consent gate once, with that paragraph; the website
already did.
## 📱 Fits a phone
- **Nothing runs off the right edge any more.** On a phone, the Dashboard's
"Top genres", "Playing right now" and chart cards, and every card on
Developers and Publishers, were wider than the screen: the counts and the
"View all" links were cut off and the page slid sideways. One long name was
enough, because a grid with no column count for small screens grows to fit
its longest line. Every grid now starts at one column that fits the screen,
and a test fails on any grid that does not.
- **Game names are back in the leaderboards.** Top Online, Top Offline and the
developer and publisher pages squeezed the name to nothing to make room for
the genre badge and the review score. On a phone those two now give way to
the name.
- **The Android app keeps out from under the status bar.** Since 2.0.0 the top
bar sat under the clock and the battery icon: the safe-area padding the 1.x
app had was lost in the rewrite. The page, the menu, the dialogs, the
back-to-top button and the notifications clear the status and navigation
bars again, and a strip behind the status bar keeps the clock readable
whichever theme the app and the phone are in. This needs Android System
WebView 136 or newer, which any phone that updates it from the Play Store
has.
- **Charts that fit.** On a phone the Anti-Cheat, Delisted and Catalogue
growth legends no longer cover the chart, axis numbers no longer print on
top of each other, and the tag cloud shows the most common tags instead of
dropping exactly those.
- **Smaller fixes.** The header search shows its hint instead of "Search by
na"; on /games a game with a long anti-cheat name no longer paints over the
next card; the consent gate scrolls to its top on a short screen; long
names and links in titles and game descriptions wrap instead of widening
the page.
## ⚡ Faster repeat visits
- **Static files are cached by what they are.** Only the hashed scripts,
styles and fonts had a lifetime; the icons, the favicon, the social card,
the manifest and Workbox's runtime were asked for again on every page load.
Workbox's hashed runtime is now cached for a year like the rest of the
build, and the art and manifest are fresh for a day and then refreshed in
the background. Pages, the service worker and the version signal still
revalidate every time, so a deploy - or a changed legal document - shows
on the next load.
- **Game art comes straight out of Cloudflare's cache.** Every thumbnail and
hero ran the site's Worker on every view, however often it had been seen -
a Worker always runs before the cache. The website now loads the AVIF
copies from the site's own image host, `media.free-steam-games.win`, which
Cloudflare caches like any static file, and falls back to the old address
by itself for art the cron has not converted yet or a browser without AVIF.
The desktop and Android apps are unchanged. The Privacy Policy now names the
image host, so returning visitors see the consent gate once, showing that
paragraph.
## 📚 Docs
- `docs/DEPLOYMENT.md` explains which commits deploy: documentation commits
stopped deploying, data commits still did, and it gives a configuration that
stops both - with the one trap: the legal documents are read by the build,
so a commit that changes only them must still trigger one.
- `docs/android-support.md` (and its Vietnamese mirror) says which Android
System WebView the safe areas need, and what to do on an older one.
+67
View File
@@ -0,0 +1,67 @@
# v4.2.0 – 2026-10-03 (The "All-Time High" Edition)
[All versions](../../../CHANGELOG.md)
Every game now shows the most players it has ever had at once, the catalogue
the site and the apps keep for offline use is a fraction of its old size and
no longer readable as text, and every open dependency alert is closed. Web
app + desktop/Android bumped `2.1.1` → `2.2.0`; repo public-facing version
`4.1.1` → `4.2.0`.
On the website all of this is already live. The desktop app offers 2.2.0
through its updater once the release is published; on Android, install the
new APK over the old one. The apps also pick up the Disclaimer's new
paragraph on where player numbers come from, so they show the consent gate
once, with that paragraph; the website already did.
## ✨ Added
- **All-time peak players.** Every game shows the most players it has ever had
at once: "All-time peak" on its page, and a sortable column in the games
table and the CSV export. The number is the peak Steam Charts has recorded,
which for a game it tracks goes back to the launch, read about once a month
per game; for the many small games Steam Charts does not track, it is the
most this project's own samples have seen. It only ever goes up. The
"(peak N)" beside the player count is gone: it was the highest of our own
occasional samples since the last full re-fetch, not a daily or all-time
peak, and it read like one. The Disclaimer names the new source, so
returning visitors see the consent gate once, showing that paragraph.
## 🗜️ A smaller, opaque offline cache
- **The catalogue your browser or app keeps for offline use is now stored as
the packed shards it downloads**, not as thousands of readable records:
about 1.4 MB instead of roughly 9.5 MB, and opaque bytes in DevTools.
Like the packed downloads, this is compression and obfuscation, not
protection: the key is public, and the dataset stays readable in Git. The
copy an earlier version saved keeps working until the data next changes,
then it is replaced and deleted. Same storage keys, so the Privacy Policy
and the consent gate are unchanged.
- Opening the cached catalogue happens off the main thread now: on a
desktop the longest freeze while loading it fell from about 20 ms to 6 ms,
for about 45 ms more until the data is ready. The two cache keys are now
written in one transaction, so a failed write can no longer leave a new
index next to old data, and a cache that will not open is simply
downloaded again.
## 🧰 Pipeline
- `scripts/refresh_peaks.py` and the daily "Refresh All-Time Peaks" workflow
(19:30 UTC) ask Steam Charts about a thirtieth of the catalogue a day, a
page every two to three seconds, and stop for the day if it ever refuses;
every run also raises the field from the pipeline's own player counts. A
manual run with `backfill` ticked asks about every game at once, in about
four hours.
## 🔐 Security
- **Every open dependency alert is closed** (19 from Dependabot, plus the few
`npm audit` adds); `npm audit` reports none. Only two of the packages run in
production: `devalue`, whose parser is in the page and the apps (5.9.2 →
5.9.4), and `urllib3` in the data pipeline (2.7.0 → 2.8.0). The rest are
build and development tools: `undici` comes up to 7.29.1 with wrangler
4.147.0, and `brace-expansion`, `fast-uri` and `serialize-javascript` are
lockfile-only bumps. SvelteKit 2 still asks for `cookie` 0.6, whose fix is
only in SvelteKit 3, so an npm override gives it 0.7.2 (same API; with the
static adapter that code only runs while the site is built). The `sharp`
override is gone: wrangler's own pin now holds the patched version.
+47
View File
@@ -0,0 +1,47 @@
# v4.2.1 – 2026-10-10 (The "Age Gate" Edition)
[All versions](../../../CHANGELOG.md)
Adult Only games now have their tags, languages and paid-DLC flag. Every
release date reads the same way, and the catalogue's text no longer carries
HTML escapes, invisible characters or Vietnamese notes. Only the data
pipeline changed: the web app and the desktop/Android apps stay at `2.2.0`,
with no new build. Repo public-facing version `4.2.0` → `4.2.1`.
The fixes reach the catalogue through the pipeline itself. The next data job
rewrites the dates, notes and text once. The next `Refresh Store Data` run
fills the games that were empty. Every app, old or new, picks the changes up
with its next catalogue download.
## 🐛 Fixed
- **Adult Only games had no tags, no languages and the wrong paid-DLC flag.**
Steam answers an anonymous visit to such a game's store page with its age
check, a Sign In page no cookie gets past, and the pipeline read that page
as the game's own: no language table, no tags, no DLC section. 25 games
were stuck that way: about 16 adult games, plus Warframe, PUBG, Rainbow Six
Siege and other age-rated games that were gated on the US servers the
pipeline runs on. Every one of them was marked "no paid DLC". A gated page
is now recognised and never read. Those games come from Steam's own store
data instead: tags, languages with their interface/audio/subtitle columns,
and the paid-DLC flag from the prices of their DLC. A game with empty tags
or languages is retried every day until they fill.
- **"Point &amp; Click".** 458 games had the tag written out with its HTML
escape, next to 10 with "Point & Click", so the tag filter listed both
(also "Design &amp; Illustration" and "Animation &amp; Modeling"). About 320
descriptions showed `&quot;` instead of quotation marks.
- TrackMania Nations Forever listed a language called "#lang_slovakian"; it
is Slovak.
## 🧹 Changed
- **One release-date format.** Every release date reads like "Aug 21, 2012".
The catalogue held three shapes: about 1,360 games in "21 Aug, 2012" and
one in Russian. Dates sent in another order or another store language are
converted when they are saved. Placeholders such as "Coming soon" are left
as they are.
- The note "Có DLC trả phí", which the browser extension wrote on 482 games,
now reads "Has paid DLC".
- Invisible characters (zero-width spaces, stray direction marks) and stray
spaces or tabs are removed from 56 games' names, developers, publishers and
descriptions. Two games listed a publisher that was only a space.
+87
View File
@@ -0,0 +1,87 @@
# v4.3.0 – 2026-10-13 (The "Autopilot" Edition)
[All versions](../../../CHANGELOG.md)
The admin can now approve the review queue on its own, a batch at a time and
within a daily limit, and it can take games out of the catalogue and put them
back. Four new admin pages show what is going on. Only the admin, its Worker
routes and the data pipeline changed: the desktop and Android apps stay at
`2.2.0` with no new build, there is no D1 migration, and the GitHub App keeps
the same permissions. Repo public-facing version `4.2.1` → `4.3.0`.
Auto-approve is **off** until it is turned on at `/admin/automation`.
## ✨ Added
- **Auto-approve.** Every 15 minutes the Worker's cron can approve one batch
of pending games, exactly as a reviewer's Approve does: a request in
`scripts/temp_info.jsonl` that the ingest still checks game by game (free,
reachable, a game, not already listed). The page sets the limits: games per
batch (up to 100), games per day (up to 500, a ceiling written in code), a
minimum wait before a game can be taken, the order, and which discovery
sources. A batch is committed only when the previous one has been ingested
and no data job is running or waiting its turn, since pushing then would
cancel that job. Anything it cannot check counts as "not now". **Run one
batch now** does one on demand, within the same limits.
- **Removing games.** `/admin/remove` takes up to 100 games out of the
catalogue at once, with a reason from a fixed list and an optional note.
Both are public. A removal is a line in the new `data/blocklist.jsonl`, and
every pipeline write leaves those games out. No scrape, re-fetch or
browser-extension push can bring one back, and discovery never proposes it
again. Each removal is logged once in `scripts/removed_games.jsonl`, so the
game's page says it was removed and why. **Restore** puts a game back in one
commit, and the game is fetched fresh from Steam. `scripts/delete_game.py`
does the same from the command line. It used to be an interactive prompt
that kept no record and did not stop the game from coming back.
- **Overview** at `/admin`, with one card each for the queue, auto-approve's
day, removals waiting for the pipeline, data jobs running now, data-quality
totals, and commit jobs that failed or are stuck. The queue moved to `/admin/queue`, and old
links are forwarded there.
- **Pipeline** (`/admin/pipeline`): the latest runs of every data workflow, and
what is running or waiting.
- **Data quality** (`/admin/quality`): published games with something missing
or unreviewed, such as safety never set or never reviewed, no genre, no tags
or no publisher. Each game links to its Edit page.
## 🐛 Fixed
- **A free DLC, demo or tool could be added as a game.** The ingest now
refuses anything Steam does not call a game, and logs it as `not_a_game`.
This applies to the browser extension too.
- `ingest_new.py` crashed on an entry whose link was a number, and would have
crashed again on every three-hourly run until the file was cleaned by hand.
A number is now read as an appid, and anything else unusable is counted as
a bad entry.
- An ingest run that waited behind a long data job worked on the data as it
was when the run was queued. It now starts from the tip of `main`.
- `Mark Dead Games` pushed with a bare `git push`, so a commit landing during
its run threw the run away. It now commits through the same
rebase-and-retry helper as every other data job.
## 🧰 Pipeline
- `scripts/remove_games.py` applies the blocklist. `Ingest New Game Links`
runs it before every ingest, and a push to `data/blocklist.jsonl` starts that
workflow. A save that would remove more than 500 games stops before writing
anything, so a damaged file fails loudly instead of emptying the catalogue.
`Check Overrides` validates the blocklist on every push that touches it.
- Discovery counts removed games as already known.
## 🔐 Security
- The app shell's lockfile takes `rustls` 0.23.45 (and `rustls-webpki`
0.103.15), closing GHSA-2mjx-qc3c-rqvc: TLS 1.3 handshake messages were
accepted across encryption-level boundaries. Only the desktop updater's
HTTPS client uses it; the Android app does not include it. The desktop app
picks it up in its next build, and 2.2.0 is unchanged.
## 🧹 Housekeeping
- 25 merged branches on GitHub, their local copies and 7 stale worktrees are
gone. GitHub now deletes a pull request's branch when it is merged.
- Dependencies: Tauri 2.12.2 and its plugins (#181), and eleven npm
minor/patch updates including Svelte 5.57.2, Vite 8.3.4 and wrangler
4.149.0 (#182). The website already runs them; the apps pick them up in
their next build. Dependabot no longer proposes SvelteKit 3,
adapter-static 4, a new Svelte, Tailwind or TypeScript major, or a
`@types/node` ahead of the Node 24 the project runs on.
+78
View File
@@ -0,0 +1,78 @@
# v4.3.1 – 2026-10-16 (The "Fair Play" Edition)
[All versions](../../../CHANGELOG.md)
Anti-cheat information comes from Steam again, for every game, and the
retired browser extension leaves the repository. Only the data pipeline, the
admin, the docs and two legal documents changed: the desktop and Android apps
stay at `2.2.0`, with no new build. Repo public-facing version `4.3.0` →
`4.3.1`.
The data catches up through the pipeline itself. The first data job after
this release cleans the notes once (about 520 games). The first anti-cheat
sweep fills and corrects every game Steam has a declaration for, and every
daily sweep after it keeps them in step.
## 🐛 Fixed
- **No game added since September had an anti-cheat.** The browser extension
was the only part of the project that read the anti-cheat a developer
declares on Steam, and it stopped in June; the pipeline itself only looked
for VAC. None of the 4,700 games added since then had one, Delta Force's
kernel-level ACE included. The pipeline now reads Steam's own declaration:
the product, whether it runs in the kernel, and whether it needs Secure
Boot. It does so when a game is added, and for the whole catalogue every
day. More than 80 games that declare an anti-cheat on Steam had none here,
among them Brawlhalla, Destiny 2, THE FINALS, Delta Force, Albion Online,
SMITE 2, Throne and Liberty and Dark and Darker; about 20 more get the
kernel flag or note they were missing. A developer who types a paragraph
where the product name goes gets a label cut to 40 characters, with the
whole text kept in the note.
- **Where the list and Steam disagree, Steam's declaration wins.** Wuthering
Waves uses ACE, not EAC; Jujutsu Kaisen Phantom Parade's anti-cheat does not
run in the kernel; Marvel Rivals' kernel flag is now known. A correction
made in the admin still beats Steam. A game that declares nothing on Steam
keeps what it has, because no declaration is not proof that a game has no
anti-cheat (Warframe, Overwatch 2 and NARAKA declare none).
- A game whose anti-cheat had been reset to an empty value had only its first
Steam category checked for VAC, and a full re-fetch reset `-` to an empty
value.
## ✨ Added
- **The anti-cheat sweep** (`scripts/refresh_anticheat.py`), at the end of the
daily Refresh Store Data run, with a commit of its own. About 160 requests
to Steam's store API cover every game; a store page is read only for a
declaration whose name the API leaves out. A manual Refresh Store Data run
with `only: anticheat` runs just the sweep.
## 🧹 Changed
- **The browser extension is archived**
([steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension);
v2.8.0 was its last release). The ingest queue (`scripts/temp_info.jsonl`)
now takes store links only: any other key on a line is ignored, and the game
is fetched from Steam. The code that merged the extension's fields is gone,
along with the field lists that existed only for it.
- The notes the extension left behind are removed: "Has paid DLC" at the
start of 491 notes (the paid-DLC flag already says it, and 10 of those notes
contradicted the flag) and "[hover-add]" on 26. A note left with nothing
else reads "Not reviewed yet".
- DISCLAIMER section 5 and Terms of Use item 5 now say where anti-cheat comes
from: the developer's declaration on Steam. On the website the consent
screen shows those two changes once.
- "Denuvo", Steam's name for Denuvo Anti-Cheat, is grouped with it in the
charts and filters.
## 🧰 Pipeline
- Refresh Store Data checks out the tip of `main` when it starts, as the
ingest does, so a run that waited its turn works on current data.
- A retired override whose old value equals its new one no longer counts as a
change on every save.
## 📚 Docs
- README, CONTRIBUTING and the contact page no longer send anyone to the
extension. A missing game or a correction goes in Discussions › Ideas, and
the manual fork path queues links only.
+24
View File
@@ -0,0 +1,24 @@
# v4.3.2 – 2026-10-16 (The "Pigeonhole" Edition)
[All versions](../../../CHANGELOG.md)
The anti-cheat charts and filters know the products Steam's declarations
brought in. Only the website's anti-cheat grouping and the pipeline's labels
changed: the desktop and Android apps stay at `2.2.0`, with no new build, and
group these products from their next release. Repo public-facing version
`4.3.1` → `4.3.2`.
## ✨ Added
- **Seven more anti-cheat families**: ACE (Anti-Cheat Expert), Anti-Cheat
Toolkit, CrackProof, HoYoKProtect, NGS (Nexon Game Security), EA Javelin and
SARD. After v4.3.1, 68 of the 159 games with a named anti-cheat sat in the
charts' "Other" slice; now 35 do, and those are one-off names a developer
typed. New games get the short name as their label; a label already stored
stays as it was written, so nothing in the catalogue is rewritten.
## 🐛 Fixed
- A product name now has to appear as a whole word to count. Matching inside
words would have filed "Space Guard", "Interface Shield" or "Peacekeeper"
under ACE, and "Vacuum Protect" under VAC.
+64
View File
@@ -0,0 +1,64 @@
# v4.3.3 – 2026-10-19 (The "Locksmith" Edition)
[All versions](../../../CHANGELOG.md)
The one open code-scanning alert is fixed, and what SonarCloud found on
`main` is fixed or accounted for: CI installs only what it has pinned and runs
no dependency's install code, the Android app stops copying its data into
Google's backup, and the parsers lose the regexes that could backtrack.
Desktop and Android bumped `2.2.0` → `2.2.1`; repo public-facing version
`4.3.2` → `4.3.3`.
The apps also catch up with the website: the new Contact page, the reworded
anti-cheat paragraphs of the Disclaimer and the Terms (so they show the
consent gate once, with those paragraphs), and v4.3.2's anti-cheat grouping.
The desktop app offers 2.2.1 through its updater once the release is
published; on Android, install the new APK over the old one.
## 🔐 Security
- **Code scanning is clean again.** The worker that decodes the catalogue now
refuses a message from any origin but its own (CodeQL
`js/missing-origin-check`). Only the page that started it can reach it, so
nothing changes for anyone; the alert had been dismissed once and came back
as soon as the code around it moved.
- **CI installs only what it has pinned.** The release workflows, which hold
the signing keys, pin every third-party action to a commit. Every `npm ci`
runs with `--ignore-scripts`, and no workflow uses `npx`. The Python
pipeline pins every package it installs, the dependencies' dependencies
included, with the hash of each file, and installs wheels only
(`--require-hashes --only-binary :all:`), so no package's setup script runs
and nothing unlisted is installed.
- **The Android app no longer takes part in Android's Auto Backup.** Left
unset, Android copied the app's storage (your consent, your settings and
the cached catalogue) into your Google account's backup, while the Privacy
Policy says none of it leaves your device. From 2.2.1 it stays there; on a
new phone you accept the terms again.
- The source no longer contains raw invisible or right-to-left control
characters: the pipeline's lists of characters to strip spell them as
escapes.
## 🧹 Changed
- Regexes that could backtrack quadratically on long input are linear now:
the store page's tags and "unsupported" language rows, the discovery
sweep's search rows, the review percentage and label, the chart colour
tokens, the legal pages' titles, the image route's capsule path and a few
more. Each new form was checked against the old one, on the dataset and on
random input.
- Lists sorted for a build hash, the sitemap or a test R2 listing state the
code-unit order they always had; the admin stylesheet puts its `@import`s
first, as CSS requires (the built stylesheet is byte-for-byte the same);
`Number.parseInt` over the global, `[[ ]]` in the bash wrappers; the unused
`normalizeLink` is gone; the Steam client mounts its retrying adapter for
https only.
- New tests pin the store page's tag and language parsing, the discovery
sweep's rows, the review summary parsing and the worker's origin check.
## 📚 Docs
- `CLAUDE.md`: the worker's origin check, the CI pinning rules (and how to add
a Python dependency), the Android backup decision. `docs/dev_env.md` and its
Vietnamese copy: run the pipeline from the repo root, with the hashed
installs; they said `cd scripts`, from where `data/` cannot be found.
`docs/DEPLOYMENT.md`: what CI checks, CodeQL and SonarCloud included.
+97
View File
@@ -0,0 +1,97 @@
# v4.4.0 – 2026-10-23 (The "Headroom" Edition)
[All versions](../../../CHANGELOG.md)
The data pipeline grows with the catalogue again. With almost 10,000 games
and a few hundred more every day, the jobs that asked Steam about one game at
a time had run out of time; they now read Steam's store API fifty games a
request, wait their turn instead of cancelling each other, and stop in time to
save. The release also carries the tooling merged since v4.3.3 - TypeScript
7, Node 26 and Python 3.15, SonarCloud in CI, the desktop updater fix - and a
certifi bump. The desktop and Android apps stay at `2.2.1`, with no new
build. Repo public-facing version `4.3.3` → `4.4.0`.
## 🧰 Pipeline
- **The data jobs scale with the catalogue again.** With almost 10,000 games
and a few hundred more every day, three jobs that asked Steam about one
game at a time had reached GitHub's six-hour limit: on 2026-10-23 Update
Reviews was stopped at exactly six hours with nothing saved. The full
assessment, with every measurement, is `docs/plan/18-pipeline-scale.md`.
- **Reviews come from Steam's store API, for every game, every day.** Fifty
games a request, about two minutes for the catalogue, instead of every two
days and five and a half hours. The percentage is now Steam's own, which
rounds down: about 4,000 games show one point less once (Counter-Strike 2
"85%" instead of "86%"), exactly as on their store pages. A summary that
says 0 reviews is double-checked game by game before it replaces a
percentage.
- **New games get their reviews again.** Steam's per-game reviews endpoint
has answered with a redirect to the store front since 2026-10-23, so the 38
games added that day were listed with "N/A". A new game now takes its
summary from the store API when that endpoint gives none, and a game never
read becomes "No reviews" until Steam counts its first one.
- **The daily purge needs two answers to remove a game.** Steam's store API
screens every game in a few minutes, and a game is removed only when
appdetails agrees; "unavailable" is asked twice, five minutes apart. A run
that would remove more than 100 games, or flags more than 500, stops before
writing anything. It also lists earlier removals that Steam has since
undone. It runs daily now, instead of a five-hour sweep on Mondays.
- **Check Dead Links is retired.** In its whole life it never found a dead
link: Steam sends a delisted game's page to the store front, which answers
200. The purge's screen sees delisted games (`unlisted`) instead.
- **No run is cancelled for waiting.** The data jobs share one queue that
used to hold a single waiting run: a third job cancelled it, and Update
Reviews lost five of ten runs that way. The queue now holds them all, first
in, first out, and every job checks out the latest `main` when it starts -
Auto Update JSON failed four days in ten from working on the data as it was
when the run was queued.
- **Every long job stops in time to save.** Each workflow gives its job a time
budget below its timeout: past it the job saves and commits what it did
instead of being stopped with nothing, and it warns before the budget gets
tight. The leaderboards skip the pauses meant for store pages (Top Online
~27 minutes instead of 48). The store-data and all-time-peak rotations
stretch their cycle as the catalogue grows instead of their daily runs.
- **Force Re-fetch runs in parts** (`1/8` … `8/8`, queued one after another),
and a game whose fetch fails keeps its old data.
## 🧰 Tooling
- **Desktop releases keep reaching the updater.** tauri-action v1 writes each
file's API address into `latest.json`, which the app's update check refuses,
so desktop 2.2.1 had to be fixed by hand before installed apps were offered
it. A new step of the release workflow now rewrites those addresses to the
release's own downloads, checking every signature on the way.
- **SonarCloud reads tests as tests**, and no longer analyses the dataset,
the Android resources the Tauri CLI generated, or the SQLite migrations its
PL/SQL analyser misread.
- **SonarCloud analyses in CI.** A workflow runs the scan on pull requests and
on `main` in place of SonarCloud's automatic analysis, with its settings in
`sonar-project.properties` (formerly `.sonarcloud.properties`). Commits that
only carry data are not scanned. It runs both test suites with coverage
first (pytest-cov for the pipeline, `npm run test:coverage` for the web
app), so SonarCloud shows what the tests reach instead of reading 0%.
- **TypeScript 7, Node 26 and Python 3.15.** The type-check runs on
TypeScript 7, the native compiler: `tsc` for the Worker, the tests and the
admin's Node code, and `svelte-check --tsgo` for the app. TypeScript 6 stays
installed beside it, because svelte-check and SvelteKit's route types still
need the JavaScript API that 7.0 does not have (the admin's svelte-check
stays on it too). CI, the release builds and Cloudflare's build run Node 26,
the LTS from 28 October; the pipeline, its tests and every data job run
Python 3.15, which writes the shards byte for byte as 3.12 did - no
re-download for anyone. The leaderboards and the dead-link log name their
encoding, so they no longer crash on Windows under an older Python. A new
test fails when one of the version pins drifts from the others, and Web CI
now runs on workflow-only changes so it sees them. The full assessment is in
`docs/plan/16-toolchain-2026.md`; `docs/plan/17-typescript-7.1.md` prepares
the move to TypeScript 7 alone once 7.1 is out.
## 🔐 Security
- **certifi 2026.10.19** (GHSA-6q48-6c7w-9gw2), the CA bundle behind every
HTTPS request the pipeline makes. eMudhra's `emSign ECC Root CA - G3` had
intermediates whose private keys were compromised; certifi 2026.10.18 - the
version pinned here - had already dropped every emSign root, and 2026.10.19
puts back the three that are not affected (G1, C1, ECC C3) while G3 stays
out. So the pipeline was never trusting the bad root, but the advisory's
range covered 2026.10.18 and pip-audit flagged it; the lock now names the
fixed release, with its hashes.
+55
View File
@@ -0,0 +1,55 @@
# v4.4.1 – 2026-10-26 (The "Tune-Up" Edition)
[All versions](../../../CHANGELOG.md)
A dependency and security pass. The desktop and Android apps take the
patched TLS stack their updater talks to the release server with; the dev
tooling, the Python pipeline and the CI workflows catch up with their
fixes. Nothing changes in how the site or the apps look or behave. Desktop
and Android bumped `2.2.1` → `2.2.2`; repo public-facing version `4.4.0` →
`4.4.1`. The desktop app offers 2.2.2 through its updater once the release
is published; on Android, install the new APK over the old one.
## 🔐 Security
- **The apps' TLS stack is patched.** rustls 0.23.46 closes four advisories,
among them an unauthenticated ServerHello that could downgrade later
connections to classical key exchange; rustls-webpki 0.103.16 and
webpki-root-certs 1.0.11 stop accepting certificates chained to the
distrusted emSign intermediates. In the apps this is the HTTPS the updater
checks for, and downloads, a new version over.
- Also in the apps: tokio, anyhow and event-listener (soundness fixes) and
plist 1.10, whose quick-xml 0.42 closes two denial-of-service advisories.
Still waiting on Tauri: the zip 4 inside its updater plugin (three
extraction advisories; the updater checks every download's signature
before it opens it), the Linux GTK 3 bindings (glib 0.18) and the
unmaintained proc-macro-error, zbus_names and zvariant. They go when Tauri
moves.
- Dev tooling: undici 7.30.1 inside wrangler's local simulator (three
advisories; it runs in `wrangler dev` and the deploy check, never in the
deployed Worker), zod 4.6.7 (in the unused-code report).
- Two SvelteKit advisories are fixed only in SvelteKit 3 and need code this
site does not have - a prerendered page forwarding an untrusted
`cache-control` to `setHeaders`, and `use:enhance` form actions - so they
are dismissed as not applicable. The move to SvelteKit 3 is a migration of
its own.
## 🧹 Changed
- Pipeline: certifi 2026.10.23 (the CA bundle the scrapers verify Steam
with), coverage 7.17.0 for the tests, both pinned with their hashes.
- Site and apps: bits-ui 2.20.2, Lucide 1.61.0, TanStack Virtual 3.13.48,
Vite 8.3.5; tooling: wrangler 4.152.0, knip 6.43.0, Tauri CLI 2.12.4.
- Merged by Dependabot since v4.4.0 and first shipped in these apps: Tauri
2.12.4; in the build tooling, fast-uri 3.1.9 and serialize-javascript 7.1.4
(two advisories).
- CI: every workflow runs on `actions/checkout` v6 and `actions/setup-python`
v6. The data jobs still on the Node 20 majors printed a deprecation warning
on every run. The release workflows take rust-cache 2.9.3.
## 📚 Docs
- `CLAUDE.md`: the undici override and when to delete it; why SvelteKit
stays on 2 and what would make the two advisories apply again.
`.github/dependabot.yml`: why checkout and setup-python majors are taken by
hand, for every workflow at once.
+38
View File
@@ -0,0 +1,38 @@
# v4.5.0 – 2026-10-26 (The "Groundwork" Edition)
[All versions](../../../CHANGELOG.md)
The site and the apps move to SvelteKit 3, the framework every page is
built on. Nothing about how they look or work should change: every page,
the Content-Security-Policy and the offline cache were compared with a
SvelteKit 2 build of the same commit before the switch. The apps also take
Tauri 2.12.5. Desktop and Android bumped `2.2.2` → `2.3.0`; repo
public-facing version `4.4.1` → `4.5.0`. The desktop app offers 2.3.0
through its updater once the release is published; on Android, install the
new APK over the old one.
## 🧹 Changed
- **The site and the apps build on SvelteKit 3** (3.1, with adapter-static
4). Nothing changes for readers: the same pages with the same text, the
same Content-Security-Policy and the same service-worker precache, each
checked against a SvelteKit 2 build of the same commit. SvelteKit 3 refuses
`svelte.config.js`, so its options moved to `web/build/sveltekit-config.ts`,
now with tests for both the web and the app policies; `$lib` imports became
`#lib`, and the `/legal/<slug>` matcher moved to `web/src/params.ts`.
- The service worker is wired into the build by `web/build/pwa.ts`, on
vite-plugin-pwa: `@vite-pwa/sveltekit` never supported SvelteKit 3.
- An old `/#/…` link to a page that no longer exists now opens the "Page not
found" page (`/error/404`); SvelteKit 3 refuses to navigate to it in place.
One that names another site (`/#//other.example/…`) is ignored.
- SvelteKit now asks the site for its version (`/_app/version.json`, a few
bytes) when a tab regains focus and once an hour, where it used to ask only
after a navigation failed. A newer deploy still changes nothing until a
navigation fails, which then reloads the page, as before.
- The desktop and Android apps take Tauri 2.12.5 (tauri-build 2.7.4).
## 🔐 Security
- The two SvelteKit advisories dismissed in v4.4.1 (GHSA-27mw-82g8-phjj,
GHSA-pfhg-q3qv-9q6r) are fixed by the upgrade, and `npm audit` reports
nothing: the `cookie` override SvelteKit 2 needed is gone.
+43
View File
@@ -0,0 +1,43 @@
# v4.5.1 – 2026-10-27 (The "Speed Bump" Edition)
[All versions](../../../CHANGELOG.md)
The site's Worker now limits how fast one address can call it, behind
Cloudflare's own rate-limiting rule at the edge. Nothing changes for readers,
the apps or the pipeline: every limit sits far above what they send. The
desktop and Android apps stay at `2.3.0`, with no new build. Repo
public-facing version `4.5.0` → `4.5.1`.
## 🔐 Security
- **Rate limits in the Worker, one budget per surface.** Per address and per
minute: the catalogue API 240 requests (loading the whole catalogue takes
about 16), the image proxy 600, the other public API routes 120, the human
check 20 (a person sends one a day) and the admin surface 300. Past a limit
the Worker answers `429 Too Many Requests` with `Retry-After: 60` until the
minute is up; the apps can read that answer, where they would otherwise have
seen a network error. An IPv6 address counts by its /64, the block one
subscriber is normally given. Cloudflare keeps these counts per server, so
they stop a client that keeps its connection open, as browsers and most
scripts do; one that reconnects for every request is left to the edge rule,
which counts exactly. They are ceilings for abuse, never quotas. The limits
are bindings in `web/wrangler.jsonc` and change by pull request.
- **Two layers, the edge first.** The zone's rate-limiting rule still refuses
a burst before the Worker runs, at no cost, and is the only limit on the
pages themselves; the Worker adds the one-minute window the Free plan's
10-second rule cannot, and keeps holding if that rule is changed. If the
Worker's limiter is ever unavailable, requests go through rather than fail.
- The recommended edge rule now covers the whole site except the hashed
JavaScript and CSS bundles, at 250 requests per 10 seconds per address. That
is about twice what a first visit sends once the offline cache fills in
(counted from the build: 110 to 130 requests in a few seconds). Applying it
is a Cloudflare dashboard change, described in `docs/SECURITY_SETUP.md` §3a.
## 📚 Docs
- `docs/SECURITY_SETUP.md` §3 describes both layers, how to check each one
with `curl`, and the Free-plan rule budget as it stands (one of one rate
limiting rule, four of five custom rules).
- `CLAUDE.md` records the layer's rules: it fails open, is not logged, keeps a
60-second period and an account-unique `namespace_id` per binding, and needs
a budget for any prefix the Worker runs first for.
+67
View File
@@ -0,0 +1,67 @@
# v4.6.0 – 2026-10-30 (The "Polyglot" Edition)
[All versions](../../../CHANGELOG.md)
The catalogue now takes free games in every language, not only the ones
that support English: about 1,300 more, most of them Chinese, Japanese or
Korean, arrive through the review queue over the next days. The site and
the apps get a language filter, search that matches across scripts and
widths, and CSV files that Excel opens correctly; and 1,357 games filed under
"Free To Play" get a real genre. Desktop and Android
bumped `2.3.0` → `2.4.0`; repo public-facing version `4.5.1` → `4.6.0`.
The desktop app offers 2.4.0 through its updater once the release is
published; on Android, install the new APK over the old one.
## ✨ Added
- **Games in every language.** Discovery used to search Steam only for free
games that list English, which left out 1,592 of them: mostly Simplified
Chinese (784), Japanese (317), Korean (165) and Traditional Chinese (164)
only, the free Japanese visual novel `//トロイメライ・ノクターン` among them.
It now proposes every free game whatever its languages, and every release
window swept before gets one more pass. The pipeline still asks Steam in English, so
tags, genres and language names stay in English; a name or description the
developer never wrote in English stays in their language.
- **A language filter on Games**, counted like the others and part of the
link (`?lang=Japanese`), so a reader can keep to the languages they read.
The About page says the catalogue now covers every language.
- **Search across scripts and widths.** Every search box (Games, the command
palette, developers, publishers and the anti-cheat list) now matches
half-width and full-width forms and hiragana and katakana as one: `トロイ`,
`とろい` and `トロイ` find the same game, and `4` finds `4`. One kanji, kana
or Hangul syllable is enough in the command palette.
- `/admin` shows a candidate's languages, with a **No English** badge when
English is not among them. Such games are decided like any other.
## 🐛 Fixed
- The header search no longer jumps to Games in the middle of a word typed
with a Japanese, Chinese or Korean input method; it waits until the word is
chosen. And it keeps its focus when it does jump: until now the next letter
typed after the jump went nowhere, whatever the language.
- A CSV export opens in Excel with its Japanese, Chinese and Korean names
intact (it now starts with a byte order mark).
- A long Chinese or Japanese description is cut at the end of a sentence
where it can be, and never ends in `、…` or `。…`.
- **"Free To Play" is no longer a genre.** Steam spells it with a capital T,
the list of names never to use as a genre had a small one, and 1,357 games
were filed under "Free To Play" - the third most common genre, and one that
says nothing about a catalogue of free games. New games get their real
genre, and the daily store refresh gives the 1,357 theirs from Steam, 150 a
day (about nine days). A genre someone set by hand is never touched.
- A queued store link written in full-width digits (`5118700`) is read
as the appid it is; digits of any other script are refused. Such an appid
used to slip through, and the next daily refresh would have stopped on it.
The blocklist now accepts exactly the lines the site's own reader does.
## 🧰 Pipeline
- Discovery runs wait in turn: backfill windows dispatched together no longer
cancel each other, and a window can be swept a whole year at a time
(`max_pages`). Each run says how many candidates do not list English.
## 📚 Docs
- `docs/plan/19-all-languages.md`: what kept these games out, what every
workflow does with them, and what is left (games not sold in the US, CJK
fonts).
+39
View File
@@ -0,0 +1,39 @@
# v4.6.1 – 2026-10-31 (The "Zip Tie" Edition)
[All versions](../../../CHANGELOG.md)
A security pass. The desktop app's updater takes the patched zip reader
v4.4.1 had to leave waiting on Tauri, and the service-worker build takes
patched glob and minimatch. Nothing
changes in how the site or the apps look or behave. Desktop and Android
bumped `2.4.0` → `2.4.1`; repo public-facing version `4.6.0` → `4.6.1`.
The desktop app offers 2.4.1 through its updater once the release is
published; on Android, install the new APK over the old one.
## 🔐 Security
- **The desktop updater's zip reader is patched.** tauri-plugin-updater
2.14.1 moves from zip 4 to zip 9.2, which closes six advisories in how an
archive is read and extracted, one of them critical: two headers in one
archive that disagree, so whatever checks an archive and whatever unpacks
it could see different files. The others are symlinks pointing out of the
destination, setuid bits and permissions carried through symlinks, an
unbounded symlink target, and an AES entry accepted without its
authentication code. The updater opens a zip only on Windows, and only
after it has checked the download's signature, so a forged archive never
reached it. Still waiting on Tauri: the Linux GTK 3 bindings (glib 0.18) and the unmaintained
proc-macro-error, zbus_names and zvariant.
- Build tooling: glob 14.0.3 and minimatch 11.0.3 in the service-worker
build, two moderate advisories published on 2026-10-30 (an aborted walk
that kept reading directories, and patterns that could take exponential
time). Only this repository's own patterns reach them, at build time; the
service worker precaches exactly the same 172 URLs as before.
- deepmerge, used by the Svelte and rollup plugins to merge their own
configuration at build time, has a low advisory with no fixed release. It
never ships to the site, the Worker or the apps, and the alert is
dismissed as a tolerable risk.
## 📚 Docs
- `CLAUDE.md`: the glob and minimatch overrides, why they are safe and when
to delete them; the undici override can go with wrangler 4.156.0.
+55
View File
@@ -0,0 +1,55 @@
# v4.7.0 – 2026-11-03 (The "Lucky Dip" Edition)
[All versions](../../../CHANGELOG.md)
Two small additions. A Random games page picks up to five games from the
catalogue when you cannot decide what to play, and the first-run terms screen
gets a way out: on the website, "Leave site" takes you back to the page you
came from; in the apps, Decline now quits, which on Android it never did. No
legal document changed, so nobody is asked to accept the terms again. Desktop
and Android bumped `2.4.1` → `2.5.0`; repo public-facing version `4.6.1` →
`4.7.0`. The desktop app offers 2.5.0 through its updater once the release is
published; on Android, install the new APK over the old one.
## ✨ Added
- **Random games.** `/random`, in the sidebar, the menu and the command
palette, with a dice button on the dashboard, rolls one to five games (five
to start with): online, offline or either, dead games only when you ask for
them, and never one marked unsafe. Roll again for a set that avoids the
games on screen; a smaller count keeps the first ones, a larger one adds to
them. Opening a game and coming back keeps the picks, and nothing is
stored: a reload rolls anew.
- **Leave site**, on the first-run terms screen and on the notice after
Decline (website only). A page may not open the browser's own start page,
so it goes back to the page before the site - the new-tab page when you
typed the address there, the search results when you came from a search -
past every page of the site you opened in between. When the site is the
first page in its tab, it says so and offers to close the tab; that takes a
second click, because closing the last tab closes the browser window too.
## 🐛 Fixed
- Declining the terms quits the Android app. It did nothing at all: the app
asked its window to close, which does nothing on Android. Both apps now quit
through Tauri's own exit, and the declined notice appears if an app is ever
still open afterwards. The apps also drop a permission nothing uses any more
(closing a window from script) for the one quitting needs.
## 🧰 Tooling & misc
- Dependencies: SvelteKit 3.1.1 and adapter-static 4.0.1, Svelte 5.57.3,
the Tauri shell plugin 2.6.0 (JavaScript and Rust together) and
single-instance 2.5.5, the updater's JavaScript side 2.14.1 (its Rust side
already was), wrangler 4.156.0, pytest 9.2.0 and the SonarCloud scan
action 8.4.0, plus patch releases of the icon, toast and virtual-list
libraries. No security advisory among them; nothing changes in how the
site or the apps behave.
- The undici override is gone: wrangler 4.156.0's local simulator pins the
patched undici 7.30.1 itself.
## 📚 Docs
- `CLAUDE.md`: how `/random` rolls and why it stores nothing; how Leave site
finds the page before the site, and why Decline quits through `exit()`.
- Both READMEs list the random page and its modules.
+99
View File
@@ -0,0 +1,99 @@
# v4.7.1 – 2026-11-09 (The "Curb Cut" Edition)
[All versions](../../../CHANGELOG.md)
An accessibility release. The repository gains an accessibility statement
that says honestly what works with a keyboard, a screen reader and zoom, and
what does not yet. The worst barriers it found are fixed:
- the games table is a real table to a screen reader;
- the first-run screens hold the keyboard focus;
- kernel-level anti-cheat is no longer told apart by colour alone;
- both themes meet the contrast WCAG asks for;
- the desktop app zooms.
Like a curb cut, most of it helps everyone. The community docs were also
brought back in line with the repository. No legal document you accept
changed, so nobody is asked to accept the terms again.
Desktop and Android go from `2.5.0` to `2.5.1`, and the repo's public version
from `4.7.0` to `4.7.1`. The desktop app offers 2.5.1 through its updater once
the release is published. On Android, install the new APK over the old one.
## ✨ Added
- **An accessibility statement.** `ACCESSIBILITY.md` says what works today
with a keyboard, a screen reader and zoom, and what does not work yet: the
games table, most charts, the first-run screens, zoom in the apps. It also
lists which browsers and apps are checked by hand, and how a report is
handled. GitHub shows it as the repository's Accessibility tab. Barriers get
their own issue form and an `accessibility` label, and the About page links
the statement and the form.
- A pull request template covering what and why, the checks to run, and a
short accessibility list for interface changes.
## 🐛 Fixed
- The About page's stack list said SvelteKit 2 and counted 3,600 rows. Its
footnote said everything the page loads comes from this site, which is not
true of Cloudflare's beacon and human check. It now says what is true: the
game data and art come from this site. The Vietnamese AI note gains the
sentence it was missing.
- Source archives (`git archive`, GitHub's "Source code" downloads) left out
three legal documents that the web build reads, so building from one
stopped. They are included now.
- **Accessibility**, on the website and in the apps from 2.5.1:
- **The games table** is now a table to a screen reader. It exposes its
roles, the row and column counts, and a position for every row, even
though only the rows on screen exist. The image, data-issue and Steam
columns have names.
- **Table rows** are no longer a link wrapped around another link, and each
row is one <kbd>Tab</kbd> stop instead of two. Clicking anywhere on a row
still opens the game.
- **The phone cards** are a list that tells a screen reader its length and
each card's position.
- **The terms screen and the human check** are dialogs that take focus, and
the page behind them is out of reach until you are through. Before, Tab
walked through the hidden page first, and Ctrl/⌘+K could open the
command palette underneath them, out of sight but holding focus.
- **Kernel-level anti-cheat** shows a shield icon and the words, not only a
red badge.
- **Contrast:**
- Light-theme links, primary buttons, warnings and badges reach 4.5:1.
The light theme's amber is a shade darker as a result.
- Red badges in the dark theme reach 4.5:1 too.
- Text boxes and drop-downs have a visible 3:1 edge in both themes.
- **Zoom:**
- The games list keeps a minimum height when zoomed in, instead of
shrinking to nothing at 300-400%.
- The desktop app zooms with Ctrl/⌘ and + / −.
- **Smaller fixes:**
- "Back to top" is out of the Tab order while it is hidden, and jumps
instead of gliding when *reduce motion* is on.
- The command palette's search box shows a focus ring.
- Screen readers read out the 💀 and the table's warning icon as words.
- `ACCESSIBILITY.md` moves all of this from "Known limitations" to "What
works today".
## 🧰 Tooling & misc
- `web/src/lib/a11y.test.ts` holds those fixes in the code. It also computes
the theme's contrast with the WCAG formula, so a colour edit that drops
below 4.5:1 for text, or below 3:1 for a control's edge, fails the tests.
## 📚 Docs
- The community docs match the repository again:
- **README:** live game-count and version badges, SvelteKit 3, every desktop
package, the shard layout, the workflows its table left out, and which
commits deploy.
- **SECURITY.md:** the real stack, pushes with the built-in token, and the
media host and the ingest and update endpoints in scope.
- **AUTHORS.md, `username.txt`, CONTRIBUTING.md and the code of conduct.**
- **The issue forms:** the hash links, GitHub Pages permalinks and the
editing and GPG options are gone. The version is under the title, not
behind a hover.
- **`web/README.md`, `docs/dev_env.md` (EN + VI), the acknowledgements and
the contact page.** Neither of the last two is a document you accept, so
nobody is asked to accept the terms again.
- `CLAUDE.md`: `ACCESSIBILITY.md` is a claim about the code, kept true in the
same pull request, and the rules behind the accessibility fixes.
+1 -1
View File
@@ -121,7 +121,7 @@ says. A configuration that does both jobs:
- Exclude: `web/src-tauri/*`, `web/README.md`
Everything not included - `data/**`, `scripts/**`, the other docs,
`CHANGELOG.md`, `CLAUDE.md`, `README.md` - then never deploys. Check it once
`CHANGELOG.md` and `changelog/`, `CLAUDE.md`, `README.md` - then never deploys. Check it once
by merging a commit that touches only `docs/plan/` (no build) and one that
touches only `docs/ToS.md` (a build), and by the next bot data commit: its
check runs on GitHub must have no `Workers Builds: free-steam-games-list`.