7 Commits
Author SHA1 Message Date
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 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 5247a3d3b3 docs: CI pinning rules, the worker's origin check, Android backup
- CLAUDE.md: the parser worker's origin check and why `e.origin &&` must
  stay; CI installs only what is pinned (action SHAs, --ignore-scripts, no
  npx, hashed Python requirements and how to add a package); the Android
  app's Auto Backup opt-out and why the policy is not the thing to change.
- docs/DEPLOYMENT.md: what web-ci and python-tests run now; CodeQL analyses
  pull requests, SonarCloud only main.
- docs/dev_env.md (and docs/i18n/vi): run the pipeline from the repo root
  with the hashed installs - `cd scripts` left data/ out of reach.
- docs/THIRD_PARTY.md: requirements-dev.txt goes in a pip call of its own.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 09:32:11 +07:00
poli0981andClaude Opus 5.5 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 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 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 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