44 Commits
Author SHA1 Message Date
poli0981andClaude Opus 5.5 d482013cf7 docs: name changelog/ where CHANGELOG.md is named
README's link, the export-ignore beside CHANGELOG.md's, the watch-paths
note in DEPLOYMENT.md, and a CLAUDE.md rule for where release notes go
and how a release moves [Unreleased] into its own file.

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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 08:54:28 +07:00
poli0981andClaude Fable 5.2 fa8dbaf92b docs: put the project in maintenance mode
The project is stable: no new features, code changes only for security
advisories and runtime/dependency updates, and issues and pull requests
are for the data (add, correct, remove a game).

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

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 20:49:27 +07:00
poli0981andClaude Opus 5.5 2b4b988cc7 docs: sync the community docs with the repository
A read-through against the code found about forty claims that had drifted.

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

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

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

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

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

CHANGELOG [Unreleased] lists all three commits.

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

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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 17:28:47 +07:00
poli0981andClaude Opus 5.5 0897443bd6 docs: the pipeline-scale assessment, CLAUDE.md, README, CHANGELOG
docs/plan/18-pipeline-scale.md holds the measurements (9,847 games,
+~280 a day), what each job cost, what GetItems answers, the direction
and what is left. CLAUDE.md gains the rules for reviews, the purge,
budgets and the data-write group; README the new schedules.

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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 10:19:52 +07:00
poli0981andClaude Opus 5.5 7449489519 docs: anti-cheat is the developer's declaration on Steam; the extension is archived
- DISCLAIMER section 5 and ToS item 5: anti-cheat is read from the
  anti-cheat disclosure on the Steam store page, which the developer fills
  in; an undeclared one shows "-", and a declaration can be wrong. Both are
  consent documents: the web gate shows these two diffs once.
- README, CONTRIBUTING, Contact (shown at /legal/contact, not
  consent-gated): no more extension; a missing game or a correction goes in
  Discussions > Ideas; the manual fork path queues store links only.
- CLAUDE.md: the anti-cheat sweep and its rules, the trio as the one manual
  set a writer replaces (an override still wins), OverrideGuard, links-only
  queue, clean_notes, the pattern mirror; 15 data writers.
- ADMIN, dev_env (+vi), web/README: the extension is no longer a producer.

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

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

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

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

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

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

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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 07:15:39 +07:00
poli0981andClaude Opus 5.5 de9d380994 feat(pipeline): refresh tags, languages and store details on a rotation
update_data.py only enriches records that are incomplete, and fetcher.py's
apply_details()/apply_scraped() only fill EMPTY fields. Once a game had its
tags, languages, platforms or header image, nothing looked at them again
short of the manual refetch_all.py. A dry run on three games found all three
with tags that had drifted since they were first fetched.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## The CSP would have bricked both packaged apps

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

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

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

## Binary 2.0.0

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

## Docs

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

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

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

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

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

Stale content removed or corrected while in here:

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

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

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

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 11:53:40 +07:00
poli0981andClaude Opus 5 a64cf6e718 chore(release): 1.4.5 / v3.4.3
App 1.4.4 -> 1.4.5 (web, desktop, Android); repo 3.4.2 -> 3.4.3. Same files
the previous release commits touched: package.json, package-lock.json,
Cargo.toml, Cargo.lock, tauri.conf.json, the README badge, and a CHANGELOG
entry covering everything since v3.4.2 - the move to free-steam-games.win, the
discovery + /admin review flow, durable overrides, the CC BY data licence,
description truncation, real URLs, security headers, and the Tauri CSP + CORS.

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

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

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

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

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

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

## Ingest: extension only

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 16:09:04 +07:00
poli0981andClaude Opus 4.8 188b403696 feat(android): minSdk → Android 11 (API 30) + hide Steam Desktop on mobile, v1.4.4 (#106)
- minSdk 24 -> 30: OS-level install gate (INSTALL_FAILED_OLDER_SDK) drops EOL
  Android 7-10 (no Google OS patches, stale WebView vs the React 19 bundle);
  minSdk 30 still reaches ~87% of active devices.
- Hide the steam:// "Steam Desktop" button on the Android app / sub-768px
  viewport via a new reactive useIsMobile hook; the Web button stays.
- Docs: new docs/android-support.md (+vi mirror) with requirement, rationale,
  tested devices (emulator 11-16, real vivo 1907 on Android 12) and a sourced
  version-share/EOL table; update TAURI.md, pc_spec.md (+vi), the
  release-android.yml notes, and the README badge/links.
- Bump 1.4.3 -> 1.4.4 (repo 3.4.1 -> 3.4.2) + Cargo.lock/package-lock sync.

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

Root cause: EChart.tsx imported the wrapper from
`echarts-for-react/lib/core` (the CommonJS build). Under Rolldown the
CJS default-interop wraps `module.exports = class` into a namespace
object, so <ReactEChartsCore/> received an object instead of a
component. Switched to the ESM build `echarts-for-react/esm/core`, which
has a clean `export default`. echarts core / echarts-wordcloud were
already ESM, so this single import was the only offender.

Verified at runtime against the production (Rolldown) build (the step
skipped in #95): bar, pie/donut, line, treemap, heatmap and wordcloud
charts all render with zero console errors; echarts/openpgp stay lazy
async chunks (not eager-preloaded).

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

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

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 20:00:02 +07:00
poli0981andClaude Opus 4.8 14b2865c5b v3.4.0: legal consent gate (web first-run + Windows installer license page) (#93)
Web/in-app first-run consent gate (ConsentGate wrapped around <App/> inside
HashRouter): full-screen card, checkbox-gated Continue, explicit Decline
(desktop quits via getCurrentWindow().close(); web shows a blocking notice).
Acceptance persisted in localStorage (f2p:legal_consent) and versioned via a
TERMS_VERSION constant so terms changes re-prompt everyone; incognito tabs get
a fresh partition so the gate re-shows there with no extra code. Error routes
(#/error/*) pass through. Doc links open via the existing openExternal() helper
so they work inside the Tauri webview.

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

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

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

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 22:40:45 +07:00
poli0981 138e5186be v3.2.7: coming-soon guard, dead-code cleanup, dev tooling (#84)
Coming-soon games rejected at ingest (health_checker COMING_SOON status). Dead-code cleanup via knip + vulture: 2 unused web files, 11 npm deps, the one-shot dedup_removed_games.py. New knip/vulture/pip-audit dev tooling + docs/THIRD_PARTY.md. Bump 3.2.6 -> 3.2.7 (desktop 1.2.6 -> 1.2.7).
2026-05-22 23:17:10 +07:00
poli0981andClaude Opus 4.7 7acdb87ea9 v3.2.6: mobile hotfix — AC Index table scroll + game card thumbnail fallback (#81)
Two mobile-viewport regressions from the v3.2.5 responsive overhaul.

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

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

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 08:44:09 +07:00
poli0981andClaude Opus 4.7 6c3454f487 v3.2.5: AC nav fix, mobile responsive tables, games/ cleanup, back-to-top (#78)
- **AC Index sidebar fix**: replace `<a href="#anchor">` with `<button onClick scrollIntoView>` in `web/src/pages/AntiCheatList.tsx`. Root cause: `main.tsx:24` uses HashRouter; `<a href="#vac">` in a hash-routed page produces `#/charts/anti-cheat/list#vac`, HashRouter parses trailing `#vac` as a route, the regex doesn't match, and the `<Route path="*" element={<Navigate to="/" replace />}>` fallback in `App.tsx` sends to Dashboard. Same fix applied to new mobile chip nav.
- **Mobile responsive**: new `web/src/components/games/table/MobileGameCards.tsx` — virtualised card list (TanStack Virtual, `estimateSize: 96`) renders below `md` while desktop table stays inside `hidden md:block`. `GamesTable.tsx` wraps both, no behaviour drift via shared `useFilters` store. `AntiCheatList` sidebar: `hidden w-48 lg:block` → `hidden md:block md:w-40 lg:w-48` + new `md:hidden` horizontal chip rail. `KpiCards` grid: insert `md:grid-cols-3` and `lg:grid-cols-4` rungs between sm-2 and xl-7.
- **games/ cleanup**: removed 93 per-genre `<genre>.md` files (`action.md`, `fps.md`, `visual-novel.md`, …) — `/games?genre=X` in the web app has replaced them since v3.0. Inbound-link audit: only `games/README.md` (regenerated) referenced them. `scripts/generate_tables.py` drops the genre loop + rewrites the README template to point at part files / leaderboards / AC list.
- **Smart regen**: `generate_tables.py` now computes `sha256` of sorted `(link, name, genre, reviews, current_players, anti_cheat, is_kernel_ac, status)` tuples, writes to `games/.gen-hash`, and short-circuits subsequent runs when the hash is unchanged. Order-invariant, ignores rendered-MD timestamps → daily workflow only commits when game data actually moves.
- **Back-to-top button**: new `web/src/components/common/BackToTop.tsx` — fixed bottom-right floating icon button, listens for `scroll` on the passed scroll-container ref (passive), fades in past 400 px threshold. Wired into `Layout.tsx` via `useRef<HTMLElement>` on `<main>`. i18n `common.backToTop` added to en + vi.
- Version bump `1.2.4` → `1.2.5` in `web/package.json`, `web/src-tauri/Cargo.toml` (+ Cargo.lock regen), `web/src-tauri/tauri.conf.json`. README badge bumped to `3.2.5`.

Verification: `npm run typecheck`, `npm run build` (2418 modules), `cargo check`, `python scripts/generate_tables.py` (first run generates + writes hash; second run skips with "no semantic changes"). 121 files changed, +391 / -2811 lines (net -2420 from 93 per-genre MD removals).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 08:08:24 +07:00
poli0981andClaude Opus 4.7 bd34905d1f v3.2.4 (cleanup): split EditGameDrawer + GamesTable, add TopOffline + AddedPerMonth charts, drop dead scripts (#74)
- Remove `scripts/discord_notify.py` (superseded by `poli0981/.github` reusable, no workflow ref) and `scripts/migrate_to_shards.py` (one-shot v2.2 migration, completed). Verified the other 8 "unreferenced" scripts all have live `bash/*.sh` wrappers and stay.
- Split `web/src/components/games/EditGameDrawer.tsx` (718 LOC) into 7 focused files under `edit/`: container keeps save handler + dialog shell; `EditFormFields`, `EditJsonView` (with `JsonDiff`), `EditChangePreview`, `ViewToggle` extract the four UI regions; `form-utils.ts` exports `gameToForm` + `formToPatch`; `types.ts` re-exports `FormState` + `View`.
- Split `web/src/components/games/GamesTable.tsx` (568 LOC) into container + 5 files under `table/`: container keeps the virtualizer (single-source row-height), filters, fuzzy search, sort, paging; `columns.tsx` extracts `COLS: ColDef[]` + width constants; `TableHeader`, `TableRow` (`React.memo`), `TableToolbar`, `ExportMenu` extract the visual regions. No behaviour change.
- Add `web/src/components/charts/TopOfflineBar.tsx` mirror of `TopOnlineBar` with offline-tier thresholds (20k/1.5k/300) matching `top_offline.py`. New page `/top-offline` registered in `App.tsx` + `Sidebar.tsx`.
- Add `web/src/components/charts/AddedPerMonthBar.tsx` aggregating `added_at` into `YYYY-MM` buckets; rendered as a third card on `charts/Time.tsx`.
- i18n: `nav.topOffline`, `topOffline.{title,subtitle,cardTitle}`, `charts.time.addedPerMonth` added to `en.json` + `vi.json`.
- README: drop duplicate "Quick Links" section; add `🎯 Top offline (md)` row; version badge `3.2.3` → `3.2.4`.
- Version bump `1.2.3` → `1.2.4` in `web/package.json`, `web/src-tauri/Cargo.toml` (+ Cargo.lock regen), `web/src-tauri/tauri.conf.json`.

Verification: `npm run typecheck`, `npm run build`, `cargo check` all green.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 00:17:24 +07:00
poli0981andClaude Opus 4.7 0b4ef48cd6 v3.2.3: View commit toast fix, offline AC lock, mark-dead-games workflow (#71)
Three patch fixes on top of v3.2.2:

- View commit toast: migrate 8 window.open() handlers in EditGameDrawer,
  Add, BulkEditDrawer, BulkActionBar to openExternal() (Tauri-safe);
  bump Sonner duration to 15s; add event.preventDefault() so toast
  persists after click. Completes follow-up flagged in v3.2.2.
- Offline AC lock: EditGameDrawer + Add OverrideFields disable + clear
  anti_cheat / anti_cheat_note / is_kernel_ac when type_game === offline.
  New i18n key edit.acLockedOffline (EN + VI).
- Mark dead games workflow: requirements.txt is at repo root, not under
  scripts/. Fix cache-dependency-path + pip install path.

Versions bumped: web/desktop 1.2.2 -> 1.2.3, repo 3.2.2 -> 3.2.3.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-17 00:05:20 +07:00
poli0981 2916afd181 v3.2.2: Bug Fix Quartet (Ctrl+K palette, Health filter, Tauri singleton, type_game inference)
Four user-reported bug fixes bundled into a patch release. See CHANGELOG v3.2.2 for the full per-file breakdown.
2026-05-11 15:44:03 +07:00
poli0981andClaude Opus 4.7 443994e91b v3.2.1: Genre cleanup (normalize JSONL + 14 new dropdown entries) (#66)
- Add scripts/normalize_genres.py — dry-run by default, --apply to write.
  Maps 10 canonical changes across 31 records (Hack & Slash, Roguelite,
  Turn-based *, Top-down Shooter, Third-person Shooter, Shoot 'em up,
  Point & Click). Idempotent; flags comma-separated values for manual
  review.
- web/src/lib/enums.ts: GENRE_ENUM 44 → 58 entries (Action RPG,
  Turn-based {RPG,Strategy,Tactics}, Real-Time Strategy, Top-down /
  Third-person Shooter, Bullet Hell, Beat 'em up, Roguelite, Hidden
  Object, Clicker, Survival Horror, Tactical RPG).
- Regenerate games/*.md tables; unique genres 100 → 92.
- Bump web/desktop 1.2.0 → 1.2.1, repo 3.2.0 → 3.2.1.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 12:25:49 +07:00
poli0981andClaude Opus 4.7 70d9730ce9 v3.2.0: SEO + Donate + auto-Discussion + Health bucket + dev docs (#64)
* v3.2.0: SEO, Donate page, Discussion auto-post, Health bucket split, dev docs

Bundles 8 features for v3.2.0 (per the planning round):

1. SEO basics — OG / Twitter card / canonical / JSON-LD in index.html;
   robots.txt + sitemap.xml in web/public; useDocumentTitle hook wired
   into every page so the tab title reflects the current route +
   language.

2. Auto-post a GitHub Discussion on release `published` —
   .github/workflows/announce-release-discussion.yml. Uses GraphQL
   `createDiscussion`, idempotent (skips if a discussion with the same
   title already exists), prefers the `Announcements` category with
   fallback to `General`.

3. Dev docs — docs/pc_spec.md, docs/dev_env.md, VI mirrors under
   docs/i18n/vi/, web/src-tauri/TAURI.md (build prerequisites + signing
   notes). AUTHORS.md gets a "Dev info" table; README.md links the new
   docs.

4. Donate page (/donate) with 5 platform cards
   (GitHub Sponsors / Ko-fi / BMC / Patreon / PayPal) sourced from
   .github/FUNDING.yml. New nav item, EN + VI i18n keys.

5. Telegram bot user guide — new docs/telegram-bot.md pointer page
   linking the external USER_GUIDE.md, bot source repo, and the
   in-repo bot-ingest.yml workflow. CONTRIBUTING.md and About page get
   the same link.

6. Health bucket split — separates "Online + AC + kernel unknown" from
   "Online · anti-cheat unknown / none" so games with empty `anti_cheat`
   no longer disappear from the report.

7. Steam Desktop direct link — game detail drawer now shows two buttons:
   `steam://store/<appid>` (Steam client) and the regular
   store.steampowered.com URL. Helper at web/src/lib/steam-link.ts.

8. Bi-weekly offline player leaderboard — scripts/top_offline.py +
   bash/offline.sh + .github/workflows/top-offline.yml (cron 1st + 15th
   of each month, plus workflow_dispatch). Output:
   games/top-offline.md, top 100 single-player F2P concurrents.
   Health page gets a manual trigger button.

Verification: `cd web && npm run typecheck && npm run build` — both
pass; PWA generates 17 precache entries; manifest.webmanifest emitted
by VitePWA as before.

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

* fix(top-offline): make update_players_only honour offline filter

`update_players_only(games)` had a hardcoded `type_game == "online"`
filter, so passing it the full games list from top_offline.py refreshed
ZERO offline player counts and the resulting top-offline.md was sorted
on stale data (last touched by the daily update_data.py).

Extend the function with a backward-compatible `type_filter` kwarg
("online" default, plus "offline" and "all"). top_online.py keeps its
existing call shape; top_offline.py now passes type_filter="offline"
which excludes online AND empty-type rows (unclassified is not
"offline").

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

* chore(release): bump to v3.2.0 / desktop v1.2.0 + CHANGELOG

- web/package.json + lockfile: 1.1.0 → 1.2.0
- web/src-tauri/tauri.conf.json: 1.1.0 → 1.2.0
- web/src-tauri/Cargo.toml: 1.1.0 → 1.2.0
- README badge: 3.1.0 → 3.2.0
- CHANGELOG.md: new v3.2.0 entry covering all 8 features in this PR

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

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 09:50:12 +07:00
poli0981andClaude Opus 4.7 16eabcbbf5 docs(v3.1.0): Telegram bot flow, AUTHORS at root, version bumps (#63)
- AUTHORS.md (new) at repo root — maintainer + canonical handle map
  + AI disclosure. Mirror of `username.txt` (now includes telegram bot,
  telegram user, email).
- assets/qr/ (new) — QR PNGs for `@my_skull_bot` and `@SkullMute0011`,
  mirrored to web/public/qr/ so the SPA serves them.
- About page (web): new Maintainer entries (Telegram bot + DM with
  inline QR thumbnails + Email) and a dedicated "Telegram QR codes"
  card with full-size scannable codes. Privacy note added.
- CONTRIBUTING.md rewrite: explicit `@my_skull_bot` flow as a
  first-class path (find user_id → DM maintainer privately → whitelist
  → run when bot's online → follow prompts). Loud warning about
  NEVER posting Telegram user_id in public channels.
- docs/PRIVACY_POLICY.md: new "Telegram bot" section covering data
  flow, storage, retention, and the maintainer's commitment.
- docs/ToS.md: new section 5.1 with non-negotiable rules about private
  vs public channels for personal info.
- docs/Contact.md: Telegram bot + DM entries at the top.
- README: version badge 3.0.0 → 3.1.0; quick links + workflow table
  + contributor section + docs index updated; Mark Dead Games and
  Bot Ingest workflows listed.
- CHANGELOG: v3.1.0 entry covering PRs #60-#62 + this docs PR.
- Versions bumped:
    web/package.json              1.0.0 → 1.1.0
    web/src-tauri/Cargo.toml      1.0.0 → 1.1.0
    web/src-tauri/Cargo.lock      1.0.0 → 1.1.0
    web/src-tauri/tauri.conf.json 1.0.0 → 1.1.0

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 21:21:02 +07:00
poli0981andClaude Opus 4.7 ee917b255a Phase 8: i18n vi/en + Tauri 2 desktop + release workflow + v3.0.0 docs refresh (#55)
i18n (vi / en)
  react-i18next + i18next-browser-languagedetector. Two resource bundles
  in web/src/i18n/locales/{en,vi}.json covering sidebar, topbar,
  dashboard, top-online, settings, common buttons (save / cancel / edit
  / delete / search / filter / clear), common toasts (saved / failed /
  verifying), the four PWA-related toasts, and the language picker
  itself. ~110 keys.

  Auto-detects from navigator.language on first load (English fallback);
  override persists in localStorage as `f2p:lang`. New Settings card with
  flag-emoji buttons.

  Long-form legal copy on /about and the static docs/* files intentionally
  stays English — translating legal wording across languages risks
  weakening the meaning, and the maintainer isn't in a position to have a
  bilingual lawyer review both bundles.

Tauri 2 desktop scaffold
  web/src-tauri/ with tauri.conf.json, Cargo.toml, build.rs, src/main.rs,
  src/lib.rs, capabilities/default.json, and PNG/ICO/ICNS icons generated
  from a Pillow-rendered source via `npx tauri icon`.

  Window: fixed 1400 × 900, resizable=false, maximizable=false,
  decorations=true, theme=Dark, centred, single instance ("main").
  Bundles `tauri-plugin-shell` so the embedded SPA can shell-open Steam
  links + GitHub URLs without granting broader native capability.

  package.json gets new scripts:
    tauri        — pass-through CLI
    tauri:dev    — dev build with hot reload from vite
    tauri:build  — release binary into src-tauri/target/release/bundle
  Plus a `build:desktop` that builds the SPA with base="/" instead of
  the GitHub Pages base.

Release workflow (.github/workflows/release-desktop.yml)
  Matrix `ubuntu-latest` / `windows-latest` / `macos-latest`. Triggers
  on push of a `desktop-v*` tag or a manual workflow_dispatch (with a
  configurable tag input).

  Steps: checkout v5 → install Linux build deps when relevant → setup
  Node 24 + npm cache → install Rust stable (with universal targets on
  macOS) → Swatinem/rust-cache → npm ci → tauri-apps/tauri-action@v0
  with releaseDraft=true so the maintainer reviews + publishes after
  smoke-testing.

  Outputs per platform:
    Windows  → .msi
    macOS    → .dmg (universal: aarch64 + x86_64)
    Linux    → .AppImage + .deb

Versioning
  Repo version badge bumped 2.1.0 → 3.0.0.
  web/package.json 0.1.0 → 1.0.0.
  src-tauri/Cargo.toml + tauri.conf.json ship at 1.0.0.
  Sidebar version label "Steam · v0.1" → "Steam · v1.0".

Docs refresh
  README.md — full rewrite of the top section: v3.0 framing (list +
  web app + desktop), refreshed quick-links table, three What's-new
  sections (web app phase summary, desktop, v2.x foundations), updated
  architecture diagram including web/ + src-tauri/, refreshed
  workflows table, refreshed contribute paths, refreshed docs index.
  CHANGELOG.md — new v3.0.0 entry consolidating phases 1 → 8 with
  per-phase one-liner summaries (including the four bug-fix points
  6.1 / 6.2 / 4.1 / 7's date-sort).
  docs/ACKNOWLEDGEMENTs.md — phase-by-phase AI-assistance table
  (Grok v1, Claude v2 + the entire v3 stack), explicit third-party
  list (Python deps + headline web/desktop deps), trademark note for
  Steam / GitHub.
  web/README.md — phases 6.1, 6.2, 7, 8 added; new Desktop builds and
  i18n sections; PWA strategy note updated to NetworkFirst.

Build 3.84 s; index chunk 113 → 136 KB gz (+22 KB for i18n + Tauri
shell wrapper). PWA precache 1.66 MiB.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-07 11:32:27 +07:00
poli0981 e408e39ea4 docs: update README for v2.1.0 release with new features and improvements 2026-03-28 15:37:16 +07:00
poli0981 ab6d6a497a v2. release 2026-03-26 10:48:59 +07:00
poli0981 f771a1591c Revise disclaimer in README for better clarity
Updated disclaimer for clarity on game quality and safety.
2026-01-16 09:49:02 +07:00
poli0981 b7f60a5ffa Add v1.1.2 Changelog, change badge version.
Signed-off-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-01-11 20:32:41 +07:00
poli0981 885b946689 Update version badge and quick links in README
Updated version badge from 1.1.0 to 1.1.1 and improved quick links section.
2026-01-07 18:44:46 +07:00
poli0981 710e91ded7 Add visitor badge to README
Added a visitor badge to track the number of visitors.
2025-12-31 18:54:48 +07:00
poli0981 26964fd8d4 Update README.md 2025-12-30 01:05:42 +07:00
poli0981 1e163472fd Update README.md with improved descriptions and links for better clarity 2025-12-22 18:18:10 +07:00
poli0981 a065bb3ff8 feat: update game data and enhance README with new structure and details 2025-12-21 07:05:54 +07:00
poli0981 9c0ee73f9f Initial commit 2025-12-19 18:30:23 +07:00